Limieten en fouten

Pagineren

Elke lijst werkt met limit en offset, en geeft terug hoeveel er in totaal zijn. Haal niet alles in één keer op: honderd per verzoek werkt prettiger dan duizend, ook voor jezelf.

curl -H "Authorization: Bearer ck_…" -H "Accept: application/json" \
     "https://app.nexym.nl/api/connect/products?limit=100&offset=200"

Wil je alleen wat er veranderd is, gebruik dan de parameter die de referentie bij die resource noemt (meestal een datum). Dat scheelt jullie allebei werk.

Limieten

Er geldt een limiet per sleutel per minuut. Zit je eraan, dan krijg je een 429 met een melding; wacht tot de volgende minuut in plaats van opnieuw te proberen.

Foutcodes

Code	Betekent	Wat je doet
401	Geen, onjuiste, ingetrokken of verlopen sleutel	Controleer de Authorization-header; de melding zegt welke van de vier
403	De sleutel mag deze resource niet	Rechten aanpassen onder API keys
404	Bestaat niet in dit project	Controleer het nummer of de resource
422	Wat je stuurde klopt niet	De melding noemt het veld
429	Te veel verzoeken	Even wachten

Krijg je HTML in plaats van JSON terug, dan ontbreekt Accept: application/json.