InicioPara proveedores logísticos Errores de la API

Errores de la API

Comprenda y resuelva los errores devueltos por la API GraphQL de Zonos.

GraphQL

La API de Zonos devuelve dos tipos de errores: códigos de estado HTTP para fallos a nivel de transporte, y errores GraphQL para problemas a nivel de aplicación. La mayoría de los errores son errores GraphQL que incluyen una clasificación en el campo extensions para ayudar a identificar la causa y la resolución adecuada.

Códigos de estado HTTP

Los errores HTTP se devuelven cuando una solicitud no puede procesarse a nivel de transporte.

Código de estado↕	Significado↕
400	Argumento no válido / solicitud incorrecta — la solicitud contiene datos de entrada no válidos.
401	No autorizado — no se proporcionaron credenciales válidas.
404	No encontrado — el recurso solicitado no existe.
409	Conflicto de recursos — la solicitud entra en conflicto con el estado actual de un recurso.
412	Condición previa no cumplida — no se cumplió una condición requerida antes del procesamiento.
422	Entidad no procesable — el cuerpo de la solicitud es estructuralmente válido pero contiene valores no válidos.
429	Límite de tasa excedido — demasiadas solicitudes en un período corto. Use retroceso exponencial y reintente.
500	Error interno del servidor — ocurrió un fallo inesperado del lado del servidor. Reintente; contacte soporte si persiste.
503	Servicio no disponible — el servicio está temporalmente fuera de línea. Reintente después de un breve retraso.
504	Tiempo de espera agotado — el servidor no recibió una respuesta a tiempo. Reintente la solicitud.

Formato de error GraphQL

Los errores a nivel de aplicación se devuelven como una lista en el campo errors del cuerpo de la respuesta. Cada error incluye un message, el path de la operación que falló y un objeto extensions con el tipo de error y el ID de solicitud.

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}

Clasificaciones de errores

El campo extensions.errorType indica la categoría del error y la acción recomendada.

Clasificación↕	Equivalente HTTP↕	Significado↕	Acción↕
`BAD_REQUEST`	400	Datos de entrada o parámetros de solicitud no válidos.	Corrija la solicitud — verifique campos requeridos, formatos y valores.
`NOT_FOUND`	404	Un recurso referenciado no existe.	Verifique IDs, códigos y que los valores predeterminados requeridos estén configurados.
`UNAVAILABLE`	503	El servicio u opción solicitada no está disponible para esta ruta.	Pruebe un método, nivel de servicio o destino diferente.
`PERMISSION_DENIED`	401 / 403	Fallo de autenticación o autorización.	Verifique credenciales y permisos de la cuenta.
`FAILED_PRECONDITION`	412	No se cumplió una condición de configuración o preparación requerida.	Verifique la configuración de la organización o contacte soporte.
`INTERNAL`	500	Ocurrió un fallo inesperado del lado del servidor.	Reintente la solicitud; contacte soporte si el problema persiste.
`UNKNOWN`	500	Un error inesperado sin clasificación adicional.	Verifique el formato de la solicitud; contacte soporte si el problema persiste.

Reservar una demostración

Errores de la API

Códigos de estado HTTP

Formato de error GraphQL

Clasificaciones de errores

¿Fue útil esta página?