HomePer i fornitori di logistica Errori API

Errori API

Comprendere e risolvere gli errori restituiti da Zonos GraphQL API.

GraphQL

Zonos API restituisce due tipi di errori: codici di stato HTTP per errori a livello di trasporto ed errori GraphQL per problemi a livello di applicazione. La maggior parte degli errori sono errori GraphQL che includono una classificazione nel campo extensions per identificare la causa e la soluzione appropriata.

Codici di stato HTTP

Gli errori HTTP vengono restituiti quando una richiesta non può essere elaborata a livello di trasporto.

Codice stato↕	Significato↕
400	Argomento non valido/richiesta errata: la richiesta contiene input non validi.
401	Non autorizzato: non sono state fornite credenziali valide.
404	Non trovato: la risorsa richiesta non esiste.
409	Conflitto di risorse: la richiesta è in conflitto con lo stato corrente di una risorsa.
412	Precondizione non riuscita: una condizione richiesta non è stata soddisfatta prima dell'elaborazione.
422	Entità non elaborabile: il corpo della richiesta è strutturalmente valido ma contiene valori non validi.
429	Rate limitato: troppe richieste in un breve periodo. Utilizzare il backoff esponenziale e riprovare.
500	Errore interno del server: si è verificato un errore imprevisto sul lato server. Riprova; contattare l'assistenza se persistente.
503	Servizio non disponibile: il servizio è temporaneamente offline. Riprovare dopo un breve ritardo.
504	Timeout: il server non ha ricevuto una risposta in tempo. Riprovare la richiesta.

Formato errore GraphQL

Gli errori a livello di applicazione vengono restituiti come elenco nel campo errors del corpo della risposta. Ogni errore include un message, il path dell'operazione non riuscita e un oggetto extensions con il tipo di errore e l'ID della richiesta.

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}

Classificazioni degli errori

Il campo extensions.errorType indica la categoria dell'errore e l'azione consigliata.

Classificazione↕	Equivalente HTTP↕	Significato↕	Azione↕
`BAD_REQUEST`	400	Parametri di input o richiesta non validi.	Correggi la richiesta: controlla i campi, i formati e i valori richiesti.
`NOT_FOUND`	404	Una risorsa referenziata non esiste.	Verificare che gli ID, i codici e che le impostazioni predefinite richieste siano configurate.
`UNAVAILABLE`	503	Il servizio o l'opzione richiesta non è disponibile per questa tratta.	Prova un metodo, un livello di servizio o una destinazione diversi.
`PERMISSION_DENIED`	401 / 403	Errore di autenticazione o autorizzazione.	Controlla le credenziali e le autorizzazioni dell'account.
`FAILED_PRECONDITION`	412	Una condizione di configurazione o impostazione richiesta non è stata soddisfatta.	Controlla le impostazioni dell'organizzazione o contatta l'assistenza.
`INTERNAL`	500	Si è verificato un errore imprevisto sul lato server.	Riprovare la richiesta; contattare l'assistenza se il problema persiste.
`UNKNOWN`	500	Un errore imprevisto senza ulteriore classificazione.	Verificare il formato della richiesta; contattare l'assistenza se il problema persiste.

Prenota una demo

Errori API

Codici di stato HTTP

Formato errore GraphQL

Classificazioni degli errori

Questa pagina è stata utile?