Fehler
Jeder Fehler ist JSON mit passendem HTTP-Status:
{
"error": "price_above_max",
"message": "Every offer costs more than max_unit_price_cents. Nothing was ordered.",
"kind": "ProductUnavailable",
"reason": "price_above_max"
}
kind: die Klasse, nach der du verzweigst.reason: die genaue Ursache (bei wenigen älteren Fehlern eine genauere Ursache;errorenthält immer den Code).- Zusätzliche Felder sagen mehr:
fieldbei falscher Eingabe,retry_afterbei 429,neededbei fehlendem Recht.
Klassen
Authentication, Authorization, Conflict, ConstraintViolation, Frozen, Gone, Idempotency, MethodNotAllowed, NotFound, ProductUnavailable, RateLimit, ServerError, SpendCap, Unavailable
Häufige Ursachen
| Status | reason | Was tun |
|---|---|---|
| 400 | idempotency_key_required | Bei jeder Bestellung einen Idempotency-Key senden. |
| 400 | max_price_required | max_unit_price_cents senden. |
| 401 | invalid_api_key, api_key_expired | Schlüssel prüfen oder neuen erstellen. |
| 403 | permission_required, ip_not_allowed | Recht ergänzen, von erlaubter Adresse aufrufen. |
| 403 | api_key_frozen | Auf die Prüfung warten; an den Support schreiben. |
| 403 | showcase_mode | Der Shop ist noch nicht geöffnet. |
| 404 | product_not_found, order_not_found | ID prüfen. Viele 404 frieren den Schlüssel ein. |
| 409 | price_above_max, no_offers | Nichts wurde bestellt. Später versuchen oder Obergrenze anheben. |
| 409 | spend_cap_reached | Tageslimit erreicht. |
| 409 | external_id_not_unique | Diese Bestellung kam schon; die Antwort nennt ihre order_id. |
| 422 | idempotency_key_reused | Derselbe Idempotency-Key mit anderem Inhalt. |
| 429 | rate_limited | Retry-After Sekunden warten. |