Zum Inhalt

Fehlertypen der Partner API

Die Partner API meldet Fehler im Format application/problem+json (RFC 9457). Das Feld type enthält die Adresse einer der folgenden Seiten und ist ein stabiler Bezeichner der Fehlerart. Werten Sie type (oder den HTTP-Status) in Ihrem Code aus, nicht den Text in title oder detail, der sich ändern kann.

Fehlertyp Status Bedeutung
Ungültige Anfrage 400 Die Anfrage konnte nicht gelesen werden, weil der Body kein gültiges JSON ist oder der falsche Content-Type gesendet wurde.
Nicht autorisiert 401 Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.
Zugriff verweigert 403 Der API-Schlüssel ist gültig, aber der Händler hat kein aktives API-Abonnement.
Nicht gefunden 404 Die angefragte Bestellung oder der Webhook existiert nicht oder gehört zu einem anderen Händler.
Bestellung existiert bereits 409 Eine Bestellung mit dieser external_order_id (oder diesem Idempotency-Key) existiert bereits, der gesendete Body weicht aber vom ursprünglichen ab.
Bestellung nicht stornierbar 409 Die Bestellung kann nicht mehr über die API storniert werden, weil sie bereits vom Händler angenommen wurde.
Validierungsfehler 422 Die Anfrage ist gültiges JSON, aber der Inhalt ist nicht zulässig.
Zu viele Anfragen 429 Das Rate Limit Ihres API-Schlüssels wurde überschritten (während der Beta 60 Anfragen pro Minute).
Interner Fehler 500 Auf unserer Seite ist ein vorübergehendes Problem aufgetreten.