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. |
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
extensionspara ayudar a identificar la causa y la resolución adecuada.