Desarrolladores

Errores

Qué es

El catálogo de errores es el contrato del fallo: cada error devuelve un código estable legible por máquina, una explicación humana y un request id. Los códigos nunca cambian de significado.

Errores

Los fallos de autenticación y permisos usan 401 y 403 estándar, y el límite de tasa devuelve 429. Los códigos siguientes son errores de negocio.

Código	HTTP	Descripción
VALIDATION_FAILED	422	La petición está mal formada: un campo ausente, un valor desconocido o una combinación inválida de parámetros.
QUOTE_INVALID	422	El token de cotización está mal formado, se emitió para otros parámetros o no puede canjearse.
QUOTE_EXPIRED	422	La ventana de validez de la cotización pasó. Pida una nueva y reserve otra vez.
SESSION_SOLD_OUT	422	La capacidad de la sesión elegida se agotó entre la cotización y la reserva.
INSUFFICIENT_BALANCE	422	Su cartera no cubre la reserva. Recargue y reintente la misma petición.
IDEMPOTENCY_CONFLICT	409	La misma Idempotency-Key se reutilizó con un cuerpo de petición distinto.
RESOURCE_NOT_FOUND	404	El recurso referenciado no existe o no es visible para su agencia.

Error envelope

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet cannot cover this booking.",
    "details": null,
    "request_id": "req_01JG80…",
    "documentation_url": "https://api.traveldistro.com/docs"
  }
}

Páginas relacionadas

¿Listo para integrar?

Cuéntenos su volumen y verticales; le prepararemos sus claves de sandbox.

Contáctenos