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. |
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
extensionsom de oorzaak en passende oplossing te identificeren.