Errores

Las respuestas de la API de Ordering normalmente usan una envoltura con un indicador error y un valor result. Una respuesta JSON exitosa generalmente tiene este aspecto:

{
  "error": false,
  "result": {}
}

Una respuesta de error establece error en true. result suele contener uno o más mensajes, y los errores de validación también pueden incluir error_codes legibles por máquina.

{
  "error": true,
  "result": [
    "You do not have permission."
  ]
}

El mensaje puede variar según el idioma seleccionado para la API. No uses su texto en inglés como un identificador programático estable.

Códigos de estado HTTP

Los códigos de estado admitidos por el contrato actual incluyen:

• 200 — la operación se completó y devolvió una envoltura de respuesta normal.
• 302 — la operación documentada redirige al cliente.
• 400 — hay una entrada no válida o falló una regla de negocio específica de la operación.
• 401 — falta autenticación o no es válida, quien realiza la solicitud no tiene el nivel de acceso requerido o falló el acceso al proyecto.
• 403 — la operación rechazó explícitamente una solicitud autenticada.
• 404 — la versión de API solicitada no está admitida; un número reducido de operaciones también documenta un 404 explícito y específico de la operación.
• 409 — la solicitud entra en conflicto con el estado actual del recurso.
• 500 — ocurrió un fallo inesperado del servidor o de inicialización del proyecto.
• 503 — la API o el proyecto no están disponibles temporalmente o están en mantenimiento.

No todas las operaciones devuelven todos los códigos de esta lista. Considera como fuente de autoridad la tabla de respuestas de la operación específica en la Referencia de la API.

Maneja los errores de forma segura

Comprueba el estado HTTP y el indicador error de la envoltura. Muestra los mensajes de result cuando sea útil, pero basa la lógica en los códigos de estado documentados o en error_codes, en lugar de comparar texto traducido pensado para personas.