> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api.md).

# Cootje API

Koppel je eigen systemen aan Cootje: overzicht van de pagina's over de API en waar je begint.

Met de Cootje API koppel je je eigen systemen aan Cootje. Dit onderdeel is bedoeld voor ontwikkelaars die een koppeling bouwen of beheren.

## In dit onderdeel

* [Authenticatie](https://docs.cootje.com/cootje-api/authenticatie.md): toegang krijgen tot de API met een API-account en een token.
  * [Token Ophalen](https://docs.cootje.com/cootje-api/authenticatie/token-ophalen.md): met een API-account een token ophalen, gebruiken en geldig houden. Begin hier.
  * [Multi Tenancy](https://docs.cootje.com/cootje-api/authenticatie/multi-tenancy.md): met één API-account voor elke omgeving een eigen token opvragen.
* [Recruitment](https://docs.cootje.com/cootje-api/recruitment.md): vacatures en kandidaten beheren, en analyses van AI opvragen.
  * [Vacatures](https://docs.cootje.com/cootje-api/recruitment/vacatures.md): ophalen, aanmaken, bijwerken, verwijderen, publiceren en de iFrame voor je website.
  * [Kandidaten](https://docs.cootje.com/cootje-api/recruitment/kandidaten.md): ophalen, aanmaken, bijwerken en verwijderen.
  * [AI Analyses](https://docs.cootje.com/cootje-api/recruitment/ai-analyses.md): de matching score van kandidaten en de zzp-validatie van vacatures.
* [Uitnodigingen / Onboarding](https://docs.cootje.com/cootje-api/uitnodigingen-onboarding.md): iemand uitnodigen om zelf zijn gegevens aan te leveren.
* [ZZP](https://docs.cootje.com/cootje-api/zzp.md): een zzp'er vastleggen, met zijn bedrijf, en een conceptcontract opmaken.
* [Inhuur](https://docs.cootje.com/cootje-api/inhuur.md): een leverancier vastleggen, met de personen die erbij horen, en een conceptcontract opmaken.
* [Tijdelijke Arbeidsovereenkomst](https://docs.cootje.com/cootje-api/tijdelijke-arbeidsovereenkomst.md): een medewerker in loondienst vastleggen en een conceptcontract opmaken.
* [Klant / Inlener](https://docs.cootje.com/cootje-api/klant-inlener.md): een klant vastleggen, met de personen die tekenen en uren goedkeuren.
* [Swagger](https://docs.cootje.com/cootje-api/swagger.md): de technische naslag met alle aanroepen.

## Goed om te weten

* Alle aanroepen gaan naar `https://mijn.cootje.com/api`.
* Vrijwel elke aanroep vraagt om een Bearer-token. Hoe je dat ophaalt, staat op [Token Ophalen](https://docs.cootje.com/cootje-api/authenticatie/token-ophalen.md).
* Een token geldt voor één omgeving. Werk je met meerdere omgevingen, lees dan [Multi Tenancy](https://docs.cootje.com/cootje-api/authenticatie/multi-tenancy.md).
* Wat een API-account mag, hangt af van de rechten van dat account in Cootje. Op elke pagina staat welk recht een aanroep vraagt. Mist het account dat recht, dan is het antwoord `401`.
* Een overzicht van alle aanroepen staat in Swagger. Waar je dat vindt en hoe je het leest, staat op [Swagger](https://docs.cootje.com/cootje-api/swagger.md).
