Changelog

Alle belangrijke wijzigingen aan de RecruitSome API worden hier gedocumenteerd.

[1.1.0] - 2026-03-27

Toegevoegd

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

API-functionaliteiten

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

[1.0.0] - 2024-01-20

Toegevoegd

• Eerste API-release
• /vacancies endpoint voor het ophalen van gepubliceerde vacatures
• /vacancies/{slug} endpoint voor vacaturedetails
• Bearer token-authenticatie
• Uitgebreide filteropties:

- Locatiefilter

- Afdelingsfilter

- Zoekfunctionaliteit

- Filter op dienstverband

- Filter op ervaringsniveau

• Paginering (maximaal 100 items per pagina)
• Sorteeropties (publicatiedatum, titel, aanmaakdatum)
• Weergavetracking voor vacaturedetails
• Rate limiting (60 verzoeken/minuut)

API-functionaliteiten

• Meertalige ondersteuning met ISO 639-1-taalcodes
• HTML-content voor functiebeschrijvingen, vereisten en aanbod
• Metadatavelden voor maatwerkkoppelingen
• URL's voor headerafbeeldingen voor visuele content
• Vereisten voor taalbeheersing
• Tracking van sollicitatie-URL's

Beveiliging

• Tenant-geïsoleerde datatoegang
• API key-authenticatie
• Veilige tokenopslag
• Rate limiting per API key

Versiebeleid

De RecruitSome API volgt semantic versioning:

• Majorversie (1.x.x): Breaking changes
• Minorversie (x.1.x): Nieuwe functionaliteiten, backwards compatible
• Patchversie (x.x.1): Bugfixes, backwards compatible

Beleid voor breaking changes

Wij zetten ons in voor API-stabiliteit. Wanneer breaking changes noodzakelijk zijn:

1. Aankondiging: 90 dagen van tevoren via e-mail en documentatie
2. Migratieperiode: Oude versie wordt minimaal 180 dagen ondersteund
3. Migratiehandleiding: Gedetailleerde documentatie voor de upgrade
4. Ondersteuning: Directe hulp voor enterprise-klanten

Deprecation-meldingen

Verouderde functionaliteiten worden aangegeven in:

• API-responses met deprecation headers
• Documentatie met duidelijke waarschuwingen
• E-mailnotificaties aan betrokken API key-houders

Blijf op de hoogte

• E-mailupdates: API key-houders ontvangen automatische notificaties
• RSS-feed: Abonneer je op https://app\.recruitsome\.com/changelog.rss
• Statuspagina: https://status.recruitsome.com