API-foutcodes
Elke API-fout heeft een vaste code. De tekst kan veranderen; bouw je koppeling daarom op de code.
Onvoldoende rechten
forbidden
- Wanneer krijg je deze fout?
- Een sleutel met alleen leestoegang probeert gegevens te wijzigen.
- Wat kun je doen?
- Gebruik een sleutel met schrijfrechten of doe alleen een leesverzoek.
Niet gevonden
not_found
- Wanneer krijg je deze fout?
- Het id bestaat niet of hoort bij een andere organisatie.
- Wat kun je doen?
- Controleer het id en de organisatie van de API-sleutel.
Ongeldige parameter
invalid_parameter
- Wanneer krijg je deze fout?
- Paginering, updated_since of de JSON-opbouw kan niet worden gelezen.
- Wat kun je doen?
- Controleer de queryparameters en stuur geldige JSON.
Validatie mislukt
validation_failed
- Wanneer krijg je deze fout?
- Een of meer velden zijn leeg, onbekend of hebben een ongeldige waarde.
- Wat kun je doen?
- Herstel de velden in errors en verstuur het verzoek opnieuw.
Verzoeklimiet overschreden
rate_limit_exceeded
- Wanneer krijg je deze fout?
- Een IP-adres of API-sleutel overschrijdt de limiet per minuut.
- Wat kun je doen?
- Wacht even en probeer het verzoek daarna opnieuw.
Idempotentiesleutel opnieuw gebruikt
idempotency_key_reused
- Wanneer krijg je deze fout?
- Dezelfde Idempotency-Key wordt binnen 24 uur met andere gegevens gebruikt.
- Wat kun je doen?
- Herhaal het oorspronkelijke verzoek of gebruik een nieuwe unieke sleutel.
Niet ondersteund inhoudstype
unsupported_media_type
- Wanneer krijg je deze fout?
- Een POST-, PATCH- of PUT-verzoek stuurt een ander inhoudstype dan JSON.
- Wat kun je doen?
- Zet Content-Type op application/json en stuur geldige JSON.
Interne fout
internal_error
- Wanneer krijg je deze fout?
- Er gaat tijdens de verwerking onverwacht iets mis.
- Wat kun je doen?
- Probeer het later opnieuw en neem contact op als de fout blijft terugkomen.