Vorschau: Capydra öffnet bald. Bestellen ist noch nicht möglich.

Capydra
Plus Hilfe Warenkorb
Deal der Woche

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; error enthält immer den Code).
  • Zusätzliche Felder sagen mehr: field bei falscher Eingabe, retry_after bei 429, needed bei fehlendem Recht.

Klassen

Authentication, Authorization, Conflict, ConstraintViolation, Frozen, Gone, Idempotency, MethodNotAllowed, NotFound, ProductUnavailable, RateLimit, ServerError, SpendCap, Unavailable

Häufige Ursachen

StatusreasonWas tun
400idempotency_key_requiredBei jeder Bestellung einen Idempotency-Key senden.
400max_price_requiredmax_unit_price_cents senden.
401invalid_api_key, api_key_expiredSchlüssel prüfen oder neuen erstellen.
403permission_required, ip_not_allowedRecht ergänzen, von erlaubter Adresse aufrufen.
403api_key_frozenAuf die Prüfung warten; an den Support schreiben.
403showcase_modeDer Shop ist noch nicht geöffnet.
404product_not_found, order_not_foundID prüfen. Viele 404 frieren den Schlüssel ein.
409price_above_max, no_offersNichts wurde bestellt. Später versuchen oder Obergrenze anheben.
409spend_cap_reachedTageslimit erreicht.
409external_id_not_uniqueDiese Bestellung kam schon; die Antwort nennt ihre order_id.
422idempotency_key_reusedDerselbe Idempotency-Key mit anderem Inhalt.
429rate_limitedRetry-After Sekunden warten.