HTTP-Statuscodes
HTTP-Fehler werden zurückgegeben, wenn eine Anfrage auf Transportebene nicht verarbeitet werden kann.
| Statuscode↕ | Bedeutung↕ |
|---|---|
| 400 | Ungültiges Argument / fehlerhafte Anfrage — die Anfrage enthält ungültige Eingaben. |
| 401 | Nicht autorisiert — es wurden keine gültigen Anmeldedaten bereitgestellt. |
| 404 | Nicht gefunden — die angeforderte Ressource existiert nicht. |
| 409 | Ressourcenkonflikt — die Anfrage steht im Widerspruch zum aktuellen Zustand einer Ressource. |
| 412 | Vorbedingung nicht erfüllt — eine erforderliche Bedingung wurde vor der Verarbeitung nicht erfüllt. |
| 422 | Nicht verarbeitbare Entität — der Anfragekörper ist strukturell gültig, enthält aber ungültige Werte. |
| 429 | Ratenlimit erreicht — zu viele Anfragen in kurzer Zeit. Verwenden Sie exponentielles Backoff und wiederholen Sie. |
| 500 | Interner Serverfehler — ein unerwarteter serverseitiger Fehler ist aufgetreten. Wiederholen; kontaktieren Sie den Support bei anhaltenden Problemen. |
| 503 | Dienst nicht verfügbar — der Dienst ist vorübergehend offline. Wiederholen Sie nach kurzer Verzögerung. |
| 504 | Zeitüberschreitung — der Server hat nicht rechtzeitig eine Antwort erhalten. Wiederholen Sie die Anfrage. |
GraphQL-Fehlerformat
Anwendungsfehler werden als Liste im Feld errors des Antwortkörpers zurückgegeben. Jeder Fehler enthält eine message, den path der fehlgeschlagenen Operation und ein extensions-Objekt mit dem Fehlertyp und der Request-ID.
1
{2
"errors": [3
{4
"message": "Description of the error",5
"path": [6
"landedCostCalculate"7
],8
"extensions": {9
"errorType": "BAD_REQUEST",10
"requestId": "req_abc123"11
}12
}13
]14
}Fehlerklassifizierungen
Das Feld extensions.errorType gibt die Fehlerkategorie und die empfohlene Maßnahme an.
| Klassifizierung↕ | HTTP-Äquivalent↕ | Bedeutung↕ | Maßnahme↕ |
|---|---|---|---|
BAD_REQUEST | 400 | Ungültige Eingabe oder Anfrageparameter. | Korrigieren Sie die Anfrage — prüfen Sie Pflichtfelder, Formate und Werte. |
NOT_FOUND | 404 | Eine referenzierte Ressource existiert nicht. | Überprüfen Sie IDs, Codes und ob erforderliche Standardwerte konfiguriert sind. |
UNAVAILABLE | 503 | Der angeforderte Dienst oder die Option ist für diese Route nicht verfügbar. | Versuchen Sie eine andere Methode, Serviceebene oder ein anderes Ziel. |
PERMISSION_DENIED | 401 / 403 | Authentifizierungs- oder Autorisierungsfehler. | Prüfen Sie Anmeldedaten und Kontoberechtigungen. |
FAILED_PRECONDITION | 412 | Eine erforderliche Konfigurations- oder Einrichtungsbedingung wurde nicht erfüllt. | Prüfen Sie Organisationseinstellungen oder kontaktieren Sie den Support. |
INTERNAL | 500 | Ein unerwarteter serverseitiger Fehler ist aufgetreten. | Wiederholen Sie die Anfrage; kontaktieren Sie den Support bei anhaltenden Problemen. |
UNKNOWN | 500 | Ein unerwarteter Fehler ohne weitere Klassifizierung. | Überprüfen Sie das Anfrageformat; kontaktieren Sie den Support bei anhaltenden Problemen. |
API-Fehler
Verstehen und beheben Sie Fehler, die von der Zonos GraphQL API zurückgegeben werden.
GraphQL
Die Zonos API gibt zwei Arten von Fehlern zurück: HTTP-Statuscodes für Transportfehler und GraphQL-Fehler für Anwendungsprobleme. Die meisten Fehler sind GraphQL-Fehler, die eine Klassifizierung im Feld
extensionsenthalten, um Ursache und geeignete Lösung zu identifizieren.