Menu

Samenvatting van de Humaans API

De Humaans REST API ontsluit het volledige HRIS via 137 endpoints, zodat je modern HR-processen kunt automatiseren en koppelen aan je overige stack. De API heeft een consistent resource-model: `list`, `retrieve`, `create`, `update`, `delete` per entiteit, met webhook-subscripties voor events.
  • Medewerker- en stamdata: Beheer people, companies, emergency contacts, identity documents en equipment met hun eigen resource-endpoints.
  • Compensation en pay: Haal bank accounts, compensations en compensation-types op voor koppeling met payroll-providers.
  • Verlof en tijdregistratie: Synchroniseer time-away, time-away-adjustments, time-logs en work-schedules met planning- en payroll-tools.
  • Performance cycles: Beheer performance-cycles, -review-templates en -reviews voor review-workflows en OKR-tooling.
  • Documenten en custom data: Upload en organiseer documents, files, folders en gebruik custom-fields/custom-values voor maatwerk-data.
  • Locaties en organisatie: Synchroniseer locations, spaces en job-roles richting facility-management en identity-provider.
API Quick Facts REST
  • Authenticatie Bearer Token
  • Methods GET (67)POST (23)PATCH (23)DELETE (24)
  • Rate limits Niet gespecificeerd
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering Header-based

Laatste ontwikkelingen bij de Humaans API

Humaans lanceerde de publieke REST API kort na de oprichting in 2020 als onderdeel van hun developer-first aanpak. De API volgt een consistent resource-model met CRUD-endpoints per entiteit en gebruikt bearer-authenticatie via `Authorization: Bearer <token>`. Versioning gebeurt via een date-based header (`Humaans-Version`), waardoor nieuwe features zonder breaking changes kunnen worden toegevoegd. In de loop der tijd zijn modules toegevoegd voor performance cycles, identity documents, custom fields, equipment-management en webhooks. Filtering ondersteunt operators als `$in`, `$gt`, `$or` voor expressieve queries.

API versies

Performance cycles Major release

Uitbreiding met performance-cycle, -review-template en -review endpoints voor gestructureerde review-workflows.

Identity documents Major release

Nieuwe identity-documents-endpoints voor paspoorten, visa en andere persoonlijke documenten naast het generieke document-model.

Equipment tracking

Equipment-, equipment-types- en equipment-names-endpoints voor het beheren van uitgegeven laptops, telefoons en andere assets.

Webhooks Major release

Webhook-subscripties voor realtime notificaties bij wijzigingen in medewerker- en verlofdata.