StartseiteFür Logistikdienstleister API-Fehler

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 extensions enthalten, um Ursache und geeignete Lösung zu identifizieren.

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.

Buchen Sie eine Demo

API-Fehler

HTTP-Statuscodes

GraphQL-Fehlerformat

Fehlerklassifizierungen

War diese Seite hilfreich?