Kliks
Lijst kliks
Webhooks
Sollicitaties
{ "count": "int", "offset": "int", "limit": "int", "rel": { "prev": "string", "next": "string" } }
HTTP-statuscode | Beschrijving |
---|---|
200 OK | Request succesvol. |
201 Created | Item is succesvol toegevoegd. |
204 No Content | Item is succesvol verwijderd. |
400 Bad Request | De request is niet succesvol door ongeldige data. |
401 Unauthorized | Ongeldige autorisatie / apikey. |
403 Forbidden | Je hebt geen toegang tot dit endpoint. |
404 Not Found | Het gebruikte endpoint bestaat niet. |
429 Too Many Requests | Het maximaal aantal requests is bereikt (rate limit). |
500 Internal Server Error | Algemene fout, neem contact op met Technicus.nl. |
{ "errors": [ { "error": "string", "label": "string", "path": "string" } ] }
Authorization: Bearer <apikey>
Partner-Authorization: Bearer <partnerkey>
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
referenceNumber | string | required | Uniek eigen referentienummer | |
title | string | required | ||
description | string | required | ||
location | string | required | Plaats of postcode | |
countryCode | string (2) | ISO 3166 | optional | |
education | string | optional | ||
experience | string | optional | ||
employment | string | optional | ||
hours | string | optional | ||
salary | string | optional | ||
industry | string | optional | ||
company | object (companyResource) | optional | ||
companyUser | object (companyUserResource) | optional | Sollicitaties worden naar dit e-mailadres verzonden | |
atsId | string | optional | ||
autoDeleteDate | string | ISO 8601 | optional | |
customFields | array (customFieldResource) | optional |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
logoUrl | string | optional | ||
description | string | optional | ||
typeId | int | optional | Gebruik waarde uit endpoint "Lijst gebruikersfuncties" |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
string | required | |||
phone | string | optional | ||
photoUrl | string | optional | ||
functionId | int | optional | Gebruik waarde uit endpoint "Lijst types" |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
value | string | required |
curl https://api.technicus.nl/vacancy \ -X POST \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json' \ -d '<payload>'
{ "vacancyId": "int", "vacancyUrl": "string" }
{ "referenceNumber": "REF12345", "title": "Senior Software Engineer", "description": "We zijn op zoek naar een ervaren Senior Software Engineer om ons groeiende engineeringteam te versterken.", "location": "Amsterdam", "countryCode": "NL", "education": "Bachelor in Computerwetenschappen", "experience": "5+ jaar in softwareontwikkeling", "employment": "Fulltime", "hours": "40 uur per week", "salary": "1000-2000 euro per maand", "industry": "Informatietechnologie", "company": { "name": "Voorbeeld Bedrijf", "logoUrl": "https:\/\/example.com\/logo.png", "description": "Beschrijving over bedrijf", "typeId": "1" }, "companyUser": { "name": "John Doe", "email": "[email protected]", "phone": "0612345678", "photoUrl": "https:\/\/example.com\/johndoe.jpg", "functionId": "1" }, "atsId": "12345", "autoDeleteDate": "2023-12-31", "customFields": [ { "name": "frameworks", "value": "Laravel, Vue.js" } ] }
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
referenceNumber | string | required | Uniek eigen referentienummer | |
title | string | required | ||
description | string | required | ||
location | string | required | Plaats of postcode | |
countryCode | string (2) | ISO 3166 | optional | |
education | string | optional | ||
experience | string | optional | ||
employment | string | optional | ||
hours | string | optional | ||
salary | string | optional | ||
industry | string | optional | ||
company | object (companyResource) | optional | ||
companyUser | object (companyUserResource) | optional | Sollicitaties worden naar dit e-mailadres verzonden | |
atsId | string | optional | ||
autoDeleteDate | string | ISO 8601 | optional | |
customFields | array (customFieldResource) | optional |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
logoUrl | string | optional | ||
description | string | optional | ||
typeId | int | optional | Gebruik waarde uit endpoint "Lijst gebruikersfuncties" |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
string | required | |||
phone | string | optional | ||
photoUrl | string | optional | ||
functionId | int | optional | Gebruik waarde uit endpoint "Lijst types" |
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
name | string | required | ||
value | string | required |
curl https://api.technicus.nl/vacancy/<vacancyid> \ -X PUT \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json' \ -d '<payload>'
{ "vacancyId": "int", "vacancyUrl": "string" }
{ "referenceNumber": "REF12345", "title": "Senior Software Engineer", "description": "We zijn op zoek naar een ervaren Senior Software Engineer om ons groeiende engineeringteam te versterken.", "location": "Amsterdam", "countryCode": "NL", "education": "Bachelor in Computerwetenschappen", "experience": "5+ jaar in softwareontwikkeling", "employment": "Fulltime", "hours": "40 uur per week", "salary": "1000-2000 euro per maand", "industry": "Informatietechnologie", "company": { "name": "Voorbeeld Bedrijf", "logoUrl": "https:\/\/example.com\/logo.png", "description": "Beschrijving over bedrijf", "typeId": "1" }, "companyUser": { "name": "John Doe", "email": "[email protected]", "phone": "0612345678", "photoUrl": "https:\/\/example.com\/johndoe.jpg", "functionId": "1" }, "atsId": "12345", "autoDeleteDate": "2023-12-31", "customFields": [ { "name": "frameworks", "value": "Laravel, Vue.js" } ] }
curl https://api.technicus.nl/vacancy/<vacancyid> \ -X DELETE \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json'
Name | Type | Format | Verplicht |
---|---|---|---|
offset | integer | optional | |
limit | integer | optional | |
startDate | string | ISO 8601 | optional |
endDate | string | ISO 8601 | optional |
referenceNumber | string | Uniek eigen referentienummer |
curl https://api.technicus.nl/vacancy/insight \ -X GET \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json'
{ "count": "int", "offset": "int", "limit": "int", "rel": { "prev": "string", "next": "string" }, "items": [ { "vacancyId": "int", "referenceNumber": "string", "publishDate": "string", "status": "int", "title": "string", "city": "string", "runtime": "int", "campaign": "string", "functionGroup": "string", "companyUser": { "name": "string", "email": "string" }, "clicks": "int", "cpc": "float", "cost": "float", "applications": "int" } ] }
curl https://api.technicus.nl/company/type \ -X GET \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json'
{ "count": "int", "offset": "int", "limit": "int", "rel": { "prev": "string", "next": "string" }, "items": [ { "id": "int", "name": "string" } ] }
curl https://api.technicus.nl/company/user/function \ -X GET \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json'
{ "count": "int", "offset": "int", "limit": "int", "rel": { "prev": "string", "next": "string" }, "items": [ { "id": "int", "name": "string" } ] }
Name | Type | Format | Verplicht |
---|---|---|---|
offset | integer | optional | |
limit | integer | optional | |
startDate | string | ISO 8601 | optional |
endDate | string | ISO 8601 | optional |
referenceNumber | string | optional |
curl https://api.technicus.nl/click \ -X GET \ -H 'Authorization: Bearer <apikey>' \ -H 'Content-Type: application/json'
{ "count": "int", "offset": "int", "limit": "int", "rel": { "prev": "string", "next": "string" }, "items": [ { "vacancyId": "int", "clickDate": "string", "referenceNumber": "string", "ip": "string", "cpc": "float" } ] }
Webhooks zijn, in tegenstelling tot onze API, endpoints die je zelf zult moeten implementeren.
Authorization: Bearer <apikey>
Naam | Type | Format | Verplicht | Beschrijving |
---|---|---|---|---|
referenceNumber | string (255) | required | Referentienummer van je vacature. | |
name | string (255) | required | Naam van de kandidaat. | |
email (255) | required | E-mailadres van de kandidaat. | ||
phone | string (255) | optional | Telefoonnummer van de kandidaat. | |
city | string (255) | optional | Woonplaats van de kandidaat. | |
motivation | text (65.535) | optional | Motivatie van de kandidaat. | |
source | string (255) | required | Bron van de sollicitatie (utm-source). | |
campaign | string (255) | required | Campagne van de sollicitatie (utm-campaign). | |
cv | string | base64 encoded string | optional | Base64 encoded string van het CV bestand (max 20MB). |
filename | string (255) | optional | Naam van het CV bestand incl. extensie. |
HTTP-statuscode | Betekenis |
---|---|
201 Created | Sollicitatie is succesvol toegevoegd. |
400 Bad Request | De request is niet succesvol door ongeldige data (graag de reden toevoegen aan de response). |
401 Unauthorized | Ongeldige autorisatie. |
De response moet een uniek id zijn van de sollicitatie of kandidaat, bv. een hash. Dit dient als bewijs dat de sollicitatie daadwerkelijk ontvangen is.
{ "id": "string" }
{ "referenceNumber": "f435a426-f656-ea11-a811-000d3a649fc7", "name": "John Doe", "email": "[email protected]", "phone": "0612345678", "city": "Amsterdam", "motivation": "Motivatie", "source": "Technicus.nl", "campaign": "Transport Campagne", "cv": "VBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPD\u2026..(truncated)", "filename": "cv.pdf" }