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 resources zijn onderaan te vinden. 

Om requests te kunnen doen naar de API moet er ook geautoriseerd worden. Dit staat beschreven onder het volgende kopje.

Authenticatie

Geef een API token mee in een GET parameter genaamd 'api_token={api_token}'. Deze API token is persoonsgebonden en kan worden aangevraagd via support@projectie.com

Request limiet

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

x-ratelimit-limitHoeveelheid requests die per minuut gedaan mogen worden
x-ratelimit-remainingHoeveelheid 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

pageGeef aan welke pagina teruggegeven moet worden
per_pageKies hoeveel items er per pagina getoond worden | Maximaal 100