StartpaginaVoor logistieke dienstverleners API-fouten

API-fouten

Begrijp en los fouten op die door de Zonos GraphQL API worden geretourneerd.

GraphQL

De Zonos API retourneert twee soorten fouten: HTTP-statuscodes voor transportfouten en GraphQL-fouten voor applicatiefouten. De meeste fouten zijn GraphQL-fouten met een classificatie in het veld extensions om de oorzaak en passende oplossing te identificeren.

HTTP-statuscodes

HTTP-fouten worden geretourneerd wanneer een verzoek op transportniveau niet kan worden verwerkt.

Statuscode↕	Betekenis↕
400	Ongeldig argument / ongeldig verzoek — het verzoek bevat ongeldige invoer.
401	Niet geautoriseerd — geen geldige credentials opgegeven.
404	Niet gevonden — de gevraagde resource bestaat niet.
409	Resourceconflict — het verzoek conflicteert met de huidige status van een resource.
412	Mislukte voorwaarde — een vereiste voorwaarde was niet voldaan vóór verwerking.
422	Niet-verwerkbare entiteit — de request body is structureel geldig maar bevat ongeldige waarden.
429	Snelheidslimiet bereikt — te veel verzoeken in korte tijd. Gebruik exponential backoff en probeer opnieuw.
500	Interne serverfout — onverwachte serverfout. Probeer opnieuw; neem contact op met support indien aanhoudend.
503	Service niet beschikbaar — de service is tijdelijk offline. Probeer opnieuw na korte vertraging.
504	Time-out — de server ontving niet op tijd een antwoord. Probeer het verzoek opnieuw.

GraphQL-foutformaat

Applicatiefouten worden geretourneerd als een lijst in het veld errors van de response body. Elke fout bevat een message, het path van de mislukte operatie en een extensions-object met het fouttype en 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}

Foutclassificaties

Het veld extensions.errorType geeft de categorie van de fout en de aanbevolen actie aan.

Classificatie↕	HTTP-equivalent↕	Betekenis↕	Actie↕
`BAD_REQUEST`	400	Ongeldige invoer of requestparameters.	Corrigeer het verzoek — controleer verplichte velden, formaten en waarden.
`NOT_FOUND`	404	Een referentieresource bestaat niet.	Verifieer ID's, codes en of vereiste defaults zijn geconfigureerd.
`UNAVAILABLE`	503	De gevraagde service of optie is niet beschikbaar voor deze route.	Probeer een andere methode, serviceniveau of bestemming.
`PERMISSION_DENIED`	401 / 403	Authenticatie- of autorisatiefout.	Controleer credentials en accountrechten.
`FAILED_PRECONDITION`	412	Een vereiste configuratie- of setupvoorwaarde was niet voldaan.	Controleer org-instellingen of neem contact op met support.
`INTERNAL`	500	Onverwachte serverfout.	Probeer opnieuw; neem contact op met support indien aanhoudend.
`UNKNOWN`	500	Onverwachte fout zonder verdere classificatie.	Verifieer requestformaat; neem contact op met support indien aanhoudend.

Boek een demo

API-fouten

HTTP-statuscodes

GraphQL-foutformaat

Foutclassificaties

Was deze pagina nuttig?