Changelog

Alle belangrijke wijzigingen aan de Recruitsome API worden hier gedocumenteerd.

[1.2.0] - 2026-06-11

Toegevoegd

• POST /vacancies/{slug}/canonical-url endpoint om de canonieke publieke URL door te geven die je website aan een vacature heeft toegekend. Doorgegeven URL's krijgen voorrang op het ingestelde URL-patroon in uitnodigingslinks. Zie Vacature-URL doorgeven
• Nieuwe vacancies:write scope, opgenomen in de Carrièrewebsite-preset

[1.1.0] - 2026-03-27

Toegevoegd

• /candidates endpoint om kandidaten uit de repository van een gebruiker op te halen
• /candidates POST endpoint om kandidaten aan te maken via cv-upload
• Kandidatenlijst ondersteunt filteren op e-mail (exacte match), zoeken en status
• Asynchrone cv-verwerking met AI-gestuurde data-extractie
• Optioneel een intake aanmaken bij het indienen van een kandidaat
• Volledige documentatie voor beide endpoints

API-functionaliteiten

• Gebruikersgebonden kandidatenrepository (kandidaten gekoppeld aan een specifieke gebruiker)
• Base64-gecodeerde cv-upload (PDF, DOC, DOCX tot 10 MB)
• Achtergrondverwerking met meldingen via assistent verzoeken
• Detectie van dubbele kandidaten en beoordelingsflow voor cv's

[1.0.0] - 2024-01-20

Toegevoegd

• Eerste API-release
• /vacancies endpoint om gepubliceerde vacatures op te halen
• /vacancies/{slug} endpoint voor vacaturedetails
• Bearer-tokenauthenticatie
• Uitgebreide filteropties:
  • Taalfilter
  • Locatiefilter
  • Afdelingsfilter
  • Zoekfunctionaliteit
  • Filteren op dienstverband
  • Filteren op ervaringsniveau
• Paginering (maximaal 100 items per pagina)
• Sorteeropties (publicatiedatum, titel, aanmaakdatum)
• Weergavetracking voor vacaturedetails
• Rate limiting (60 verzoeken per minuut)

API-functionaliteiten

• Meertalige ondersteuning met ISO 639-1 taalcodes
• HTML-content voor functiebeschrijvingen, vereisten en aanbod
• Metadatavelden voor aangepaste integraties
• Headerafbeelding-URL's voor visuele content
• Taalvaardigheidsvereisten
• Tracking van sollicitatie-URL's

Beveiliging

• Tenantgeïsoleerde datatoegang
• API sleutel-authenticatie
• Veilige tokenopslag
• Rate limiting per API sleutel

Versiebeleid

De Recruitsome API volgt semantische versiebeheer:

• Hoofdversie (1.x.x): Niet-compatibele wijzigingen
• Subversie (x.1.x): Nieuwe functionaliteiten, achterwaarts compatibel
• Patchversie (x.x.1): Bugfixes, achterwaarts compatibel

Niet-compatibele wijzigingen worden vooraf aangekondigd in deze changelog en in het Updatecentrum in de applicatie.