Headless API

Hoe te gebruiken?

Het gebruiken van de API is mogelijk door de url van deze website te gebruiken er er "/api" achter te plaatsen gevolgd door de gewenste resource. De opties per resource beschreven op hun eigen documentatie pagina.

De API is alleen te bereiken via HTTPS

Om requests te kunnen doen naar de API moet er ook geautoriseerd worden. De authenticatie flow staat beschreven op de authenticatie pagina.

Request limiet

Er is een limiet voor het doen van aanvragen naar een API resource. Er mag een maximum van 60 requests per minuut gedaan worden. Bij iedere request worden de volgende headers in de response mee gegeven

x-ratelimit-limit Hoeveelheid requests die per minuut gedaan mogen worden
x-ratelimit-remaining Hoeveelheid requests die nog gedaan mogen worden deze minuut.

Als de limiet wordt overschreven zal er een extra header worden terug gegeven.

retry-after     De hoeveelheid tijd in seconden die gewacht moet worden voordat de request opnieuw uitgevoerd mag worden

Pagination

Sommige resultaten worden opgedeelt in pagina's. Deze urls zijn aangegeven doordat er | Paginated achter de beschrijving staat. Er kan gewisseld worden van pagina door een GET parameter genaamd 'page={pagina_nummer}' mee te geven

De volgende parameters kunnen meegegeven worden om de pagination te beinvloeden

page Geef aan welke pagina teruggegeven moet worden
per_page Kies hoeveel items er per pagina getoond worden | Maximaal 100