Aan de slag
Fouten
Als er iets misgaat, antwoordt de API met de bijbehorende HTTP-status en een body met code en message binnen error.
Gebruik code in uw programma. message is een Engelse tekst die helpt bij het debuggen en kan veranderen.
Indeling van de fout404
{
"error": {
"code": "not_found",
"message": "Item not found or you do not have access to it."
}
}Geen sleutel401
{
"error": {
"code": "missing_api_key",
"message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
}
}Foutcodes
| Status | Code | Wanneer dit gebeurt |
|---|---|---|
| 400 | key_in_query |
De sleutel is in de URL meegestuurd (parameters api_key, apikey, key of token). Stuur hem mee in de header en genereer een nieuwe sleutel, want de vorige kan in logs zijn vastgelegd. |
| 400 | invalid_parameter |
Een parameter heeft een ongeldige waarde, zoals per_page boven het maximum. |
| 401 | missing_api_key |
Het verzoek bevatte geen sleutel. |
| 401 | invalid_api_key |
De sleutel bestaat niet, is ingetrokken of de gebruiker ervan is gedeactiveerd. |
| 404 | not_found |
Het endpoint bestaat niet, of het item bestaat niet of hoort bij een organisatie die de gebruiker niet kan zien. |
| 404 | organization_not_found |
De opgegeven organization is geen organisatie waarin de gebruiker dit type item kan zien. |
| 405 | method_not_allowed |
De API accepteert alleen GET (en HEAD). |
| 429 | rate_limited |
De verzoeklimiet is bereikt. Wacht het aantal seconden uit Retry-After af. |
| 500 | server_error |
Interne fout. Probeer het zo opnieuw; blijft de fout optreden, neem dan contact op met support. |
Wanneer u het opnieuw kunt proberen
Herhaal hetzelfde verzoek alleen na een 429 (na de wachttijd uit Retry-After) of een 500. Bij andere fouten moet het verzoek of de sleutel worden aangepast.