Circuitos para vender mejor
Circuitos para agencias con mirada comercial
Partners API
Ponemos a disposición de agencias y partners una API clara y documentada para consultar catálogo, salidas y reservas sobre el mismo inventario operativo que utilizamos en la web.
Integración disponible
Una agencia puede trabajar nuestro producto de forma manual desde la web, y otra con más estructura técnica puede conectarse a la API sin perder el mismo contexto operativo.
Consulta circuitos publicados, revisa cada salida disponible y trabaja siempre sobre el mismo inventario operativo que utiliza la web.
Cada partner trabaja con su propia API key, de forma controlada y trazable, para operar solo sobre su canal.
Consulta circuitos publicados, revisa cada salida disponible y trabaja siempre sobre el mismo inventario operativo que utiliza la web.
Cada partner trabaja con su propia API key, de forma controlada y trazable, para operar solo sobre su canal.
La creación de reservas utiliza Idempotency-Key para evitar duplicidades y devolver la misma operación si el intento se repite.
Cada operación devuelve un identificador único para facilitar el seguimiento, el soporte y la revisión de incidencias.
Headers aceptados
x-api-key: <api-key>
Authorization: Bearer <api-key>
Headers de respuesta
Notas operativas
Validar conectividad con /api/v1/health.
Descargar catálogo con /api/v1/circuits.
Consultar salidas con /api/v1/departures.
Crear reservas con Idempotency-Key único por intento lógico.
Guardar requestId, reference y externalReference en el sistema del partner.
Consultar estado posterior vía /api/v1/reservations/{reference}.
Soporte técnico
Para incidencias, enviad siempre `requestId`, `reference`, `externalReference` y fecha/hora de la llamada a santiago@destinotour.com.
| Método | Path | Descripción | Auth |
|---|---|---|---|
| GET | /api/v1/health | Estado básico del servicio. | Público |
| GET | /api/v1/openapi | Contrato OpenAPI vivo en JSON. | Público |
| GET | /api/v1/circuits | Listado de circuitos publicados. | API key |
| GET | /api/v1/circuits/{slug} | Detalle de circuito con salidas futuras. | API key |
| GET | /api/v1/departures | Salidas futuras. Admite filtro ?circuit=<slug>. | API key |
| POST | /api/v1/reservations | Crea una reserva en estado HELD. | API key + Idempotency-Key |
| GET | /api/v1/reservations/{reference} | Consulta el estado de una reserva. | API key |
Recursos descargables
Si tu equipo técnico quiere empezar sin leer toda la página, aquí tiene un paquete base con colección Postman, ejemplo de payload y checklist operativa de puesta en marcha.
Requests listos para healthcheck, catálogo, salidas, creación de reserva y consulta por referencia.
destino-tour-api.postman_collection.json
DescargarPayload base para POST /api/v1/reservations con los campos operativos esperados por la API.
destino-tour-reservation-example.json
DescargarLista rápida para validar autenticación, errores, idempotencia, trazabilidad y salida a producción.
destino-tour-onboarding-checklist.md
DescargarAntes de integrar, recomendamos validar conectividad, autenticación y creación de reserva con una credencial de partner.
Healthcheck
curl https://destinotour.com/api/v1/healthCircuitos
curl -H "x-api-key: <api-key>" \
https://destinotour.com/api/v1/circuitsLa API devuelve reservas en estado `HELD` y reutiliza la misma reserva si la misma `Idempotency-Key` se repite dentro del mismo canal.
curl -X POST https://destinotour.com/api/v1/reservations \
-H "x-api-key: <api-key>" \
-H "Idempotency-Key: partner-123-order-987" \
-H "Content-Type: application/json" \
-d '{
"departureId": "cmobt3zxw000aegoaual0bse2",
"customerName": "Juan Perez",
"customerEmail": "juan.perez@example.com",
"customerPhone": "+34638875747",
"passengerCount": 2,
"adults": 2,
"children": 0,
"externalReference": "ORDER-987",
"notes": "Reserva desde integración partner"
}'Payload inválido o falta Idempotency-Key.
API key ausente o inválida.
IP no autorizada o reserva de otro integrador.
Recurso no encontrado.
Sin disponibilidad o salida no operativa.
Rate limit excedido.
Error interno.
La documentación navegable vive en Redoc y Swagger, pero el contrato fuente de la API sigue siendo el JSON OpenAPI publicado en `/api/v1/openapi`.
Podemos coordinar una prueba de extremo a extremo con una credencial de partner y revisar juntos autenticación, catálogo, salidas, reservas e idempotencia.