Fehler & Limits
Authentifizierung und Validierung können eine Anfrage vor der Ausführung ablehnen. Beachten Sie die Fehlerreferenz und bewahren Sie request_id für den Support auf. Senden Sie niemals Schlüssel oder Passwörter.
Antworten · HTTP
| HTTP | Beschreibung |
|---|---|
400 / 422 | Parameternamen, Typen, Grenzen und Pflichtwerte prüfen. |
401 | Gültigen aktuellen Schlüssel im Authorization-Header verwenden. |
403 | Kontozugriff, wirksame Berechtigungen, Verifizierung und Quell-IP-Liste prüfen. |
404 | Eigene Datensatz-ID prüfen; fremde Kontodaten werden nicht offengelegt. |
409 | Revision/Angebot neu lesen und ursprünglichen Vorgang vor Wiederholung abgleichen. |
429 | Retry-After abwarten, danach begrenzt weiter abfragen. |
5xx / timeout | Unklarer Schreibstatus ist kein Fehlschlag. Denselben Vorgang abfragen, keinen neuen Kauf oder Änderung senden. |
Fehler & Limits · HTTP 429
Standardmäßig gelten 60 Anfragen je Kalenderminute; der Administrator kann dies ändern. Beachten Sie capabilities.limits und Retry-After bei HTTP 429. Schlüsselerneuerung setzt die Nutzung nicht zurück.
Retry-After: 15
{
"ok": false,
"error": { "code": "RATE_LIMITED" },
"meta": { "request_id": "000000000000000000000429" }
}Idempotency-Key
Speichern Sie pro beabsichtigter Änderung einen Idempotency-Key. Timeout oder HTTP 5xx beweist keinen Fehlschlag. Fragen Sie den Status mit demselben Schlüssel ab; starten Sie bei Unklarheit keinen neuen Schreibvorgang.