Publieke API

401, 403, 422 en 429 diagnosticeren

401 betekent dat de sleutel helemaal niet geaccepteerd is. 403 betekent dat hij wel geaccepteerd is maar de handeling niet mag. 422 betekent dat het verzoek begrepen is en de payload fout was. 429 betekent dat je over de rate limit zit en beter kunt wachten dan meteen opnieuw proberen.

Gecontroleerd op 20 augustus 2026

Stappen

1. Bij 401 controleer je of de sleutel bestaat, niet verlopen is en in de header meegaat die je denkt — meestal is een afgekapte plakactie de oorzaak.
2. Bij 403 lees je de code: onvoldoende scope, een adres buiten de allow-list, of een sleutel van een andere workspace. Opnieuw verbinden helpt niet; het recht moet veranderen.
3. Bij 422 lees je het veld dat het antwoord noemt en corrigeer je de payload.
4. Bij 429 volg je de rate-limit-headers en wacht je. Meteen opnieuw sturen maakt het erger.
5. Bewaar de requestId uit het antwoord — daarmee vindt support precies jouw aanroep.

Hoe je het resultaat controleert

Hetzelfde verzoek slaagt na de correctie, en het antwoord draagt een 2xx-status met het verwachte object.

Wat er meestal misgaat

• Een 403 behandelen als een slechte sleutel en hem opnieuw uitgeven, wat niets verandert.
• Een 429 in een strakke lus herhalen.
• De sleutel naar support sturen in plaats van het request-id.