Solliciteer via de API

Een cv in een formulier slepen kan iedereen. Jij bouwt liever iets: stuur je sollicitatie als POST request. Elke aanroep is standaard een test, dus je kunt vrij experimenteren voordat je het echt doet.

Endpoint

De slug staat in de URL van elke vacature op careers.zonneplan.nl/vacatures.

POST https://careers.zonneplan.nl/api/apply/{vacature-slug}

Testmodus

Elke aanroep is standaard een test: we valideren je payload en sturen terug wat we ervan begrepen, zonder iets vast te leggen. Zet "test": false in de body en je solliciteert echt.

Wat de recruiter ziet

Je sollicitatie krijgt een notitie mee dat hij via deze API binnenkwam, met de client waarmee je hem stuurde. Verder behandelen we hem precies zoals elke andere sollicitatie.

Limieten

Vijf aanroepen per uur per IP adres.
Eén echte sollicitatie per uur per IP adres.
Maximaal 4MB per verzoek, inclusief je cv.

Velden

Veld	Type	Toelichting
first_name	string, verplicht	Je voornaam.
last_name	string, verplicht	Je achternaam.
email	string, verplicht	Een geldig e-mailadres.
telephone	string, optioneel	Je telefoonnummer.
motivation	string, optioneel	Je motivatie, maximaal 5000 tekens.
cv	string, optioneel	Je cv als base64, zonder data URL prefix. Zonder cv komt je sollicitatie gewoon binnen.
cv_extension	string, optioneel	Extensie van het cv, standaard pdf.
linkedin_url	string, optioneel	Link naar je LinkedIn profiel.
github_url	string, optioneel	Link naar je GitHub profiel.
test	boolean, standaard true	Zet op false om echt te solliciteren.

Voorbeeld

curl -X POST https://careers.zonneplan.nl/api/apply/data-scientist \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jouw voornaam",
    "last_name": "Jouw achternaam",
    "email": "jouw@emailadres.nl",
    "telephone": "Jouw telefoonnummer",
    "motivation": "Jouw motivatie voor deze vacature",
    "cv": "Jouw cv als base64, zonder data URL prefix",
    "cv_extension": "pdf",
    "linkedin_url": "https://www.linkedin.com/in/jouw-profiel",
    "github_url": "https://github.com/jouw-profiel",
    "test": true
  }'

Dit voorbeeld toont alle velden. Alleen je voornaam, achternaam en e-mailadres zijn verplicht; je cv en de rest mag je weglaten.

Antwoord van een testaanroep:

{
  "ok": true,
  "test": true,
  "message": "Dit was een testaanroep. Er is niets verstuurd.",
  "vacancy": {
    "slug": "data-scientist",
    "title": "Data Scientist",
    "department": "Development"
  }
}

Statuscodes

200	Testaanroep gelukt. Er is niets verstuurd.
201	Sollicitatie aangenomen.
400	Ongeldige JSON of een veld dat niet klopt.
404	Geen vacature met deze slug.
413	Verzoek groter dan 4MB.
429	Te veel aanroepen. Kijk naar de Retry-After header.
502	Het recruitmentsysteem nam de sollicitatie niet aan.

Liever gewoon het formulier? Bekijk de vacatures.