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. |