API

Gebruik onze API voor het eenvoudig plaatsen, wijzigen en verwijderen van vacatures.

Stap 1: vind je API-sleutel

1) Log in als werkgever
2) Ga naar "Instellingen"
3) Kopieer de API-sleutel onderaan de pagina

API endpoint

http://12jobs.nl/api

Response codes

Responses voor POST-requests worden in JSON gegeven.

status
"ok"
status
"error"
errorDescription
Als er een foutmelding is, omvat dit de omschrijving van de foutmelding.
oid
[int] Als het plaatsen of updaten van een vacature succesvol voltooid is, staat hier de vacature-id.
Vacature succesvol verwijderd? Response oid = 0

Nieuwe vacature plaatsen

HTTP POST naar de endpoint.

Alle velden zijn verplicht. De velden zijn hoofdlettergevoelig.

action
"new"
Stuur een veld mee met key = action en value = new
key
[string] Je API-sleutel
branchID
[int] ID van de branche waarin de vacature valt
(zie onder voor het opvragen van categorieën)
categoryID
[int] ID van de functiegroep
jobHoursID
[int] ID van het aantal uren per week
edLevelID
[int] ID van het vereiste opleidingsniveau
regionID
[int] ID van de geografische regio waar de vacature is
jobTypeID
[int] ID van het soort dienstverband
salaryIndicationID
[int] ID van de salarisindicatie
oTitle
[string] Titel van de vacature
oDescription
[string] Omschrijving van de vacature, minimaal 20 tekens.
Nota bene: geen HTML
oRequirements
[string] Vereisten van de vacature, minimaal 20 tekens.
oCity
[string] Plaats (stad) van de vacature
eContactGender
[int] Geslacht van de contactpersoon
1 = man; 0 = vrouw
eContactNameF
[string] Voornaam van de contactpersoon
eContactNameL
[string] Achternaam van de contactpersoon
eContactEmail
[string] Email adres van de contactpersoon
ePhone
[optioneel] [string] Telefoonnummer van de contactpersoon
eContactURL
[optioneel] [string] URL om te solliciteren. Als deze is weggelaten, wordt de algemene URL van het bedrijf getoond.

Vacature wijzigen

HTTP POST naar de endpoint.
Dezelfde velden als bij het plaatsen van de vacature, en bovendien:

action
"update"
Dit in plaats van action=new.
oid
[int] De ID van de te wijzigen vacature

Vacature verwijderen

HTTP POST naar de endpoint.

action
"delete"
Stuur een veld mee met key = action en value = delete
key
[string] Je API-sleutel
oid
[int] De ID van de te verwijderen vacature

Tonen van je vacatures

HTTP POST naar de endpoint.

action
"list"
key
Je API-sleutel

Het resultaat is een array met de ID's van de vacatures.

Opvragen van categorieën

HTTP GET naar http://12jobs.nl/api?list=
Bijv. http://12jobs.nl/api?list=branches

branches
De branches waarin een vacature geplaatst kan worden.
categories
De functiegroepen waarin een vacature geplaatst kan worden.
jobHours
Het aantal uren per week
edLevels
Minimaal vereiste opleidingsniveau
regions
Geografische regio's
jobTypes
Dienstverbanden
salaryIndications
Salarisindicaties

Het resultaat bevat zowel de ID  als de naam, in JSON.

Vragen?

Stuur een mail naar [email protected].

12jobs XML-feed

Voor het opnemen van de vacatures van 12jobs kan je gebruik maken van onze XML-feed:

http://12jobs.nl/jobfeed.xml