Öffentliche API

401, 403, 422 und 429 diagnostizieren

401 heißt, der Schlüssel wurde gar nicht akzeptiert. 403 heißt, er wurde akzeptiert, aber die Operation ist nicht erlaubt. 422 heißt, die Anfrage wurde verstanden und die Nutzlast war falsch. 429 heißt, Sie liegen über dem Rate Limit und sollten warten statt sofort erneut zu senden.

Geprüft 20. August 2026

Schritte

1. Bei 401 prüfen, ob der Schlüssel existiert, nicht abgelaufen ist und im gedachten Header gesendet wird — meist ist ein abgeschnittenes Einfügen die Ursache.
2. Bei 403 den code lesen: unzureichender Scope, eine Adresse außerhalb der Allow-List oder ein Schlüssel eines anderen Arbeitsbereichs. Neu verbinden hilft nicht; die Berechtigung muss sich ändern.
3. Bei 422 das in der Antwort genannte Feld lesen und die Nutzlast korrigieren.
4. Bei 429 die Rate-Limit-Header beachten und warten. Sofort erneut senden macht es schlimmer.
5. Bewahren Sie die requestId aus der Antwort — damit findet der Support genau Ihren Aufruf.

So prüfen Sie das Ergebnis

Dieselbe Anfrage gelingt nach der Korrektur, und die Antwort trägt einen 2xx-Status mit dem erwarteten Objekt.

Was meistens schiefgeht

• 403 als schlechten Schlüssel behandeln und ihn neu ausstellen, was nichts ändert.
• Eine 429 in einer engen Schleife wiederholen.
• Dem Support den Schlüssel statt der Request-ID schicken.