Traslados con conductor dentro de tu producto

Cómo funciona una integración

1. Paso 1

   Presupuesto

   POST /api/v1/presupuesto devuelve el precio con IVA, la distancia, el tiempo y el precio de canal.

2. Paso 2

   Reserva

   POST /api/v1/reservas registra la contratación previa a nombre de tu cliente y devuelve el código.

3. Paso 3

   Seguimiento

   GET /api/v1/reservas/{code} o avisos firmados a tu sistema: estado, conductor, vehículo y vuelo.

4. Paso 4

   Liquidación

   Neto con tu margen o comisión sobre el servicio prestado, con factura mensual.

Tu primera llamada, sin clave

El catálogo de rutas con precio es público: prueba la API ahora mismo.

Referencia por áreas

Cómo trabaja la API

• Un solo precio: el presupuesto de la API es el que se cobra, calculado con el mismo código que la web.
• Contrato estable: dentro de v1 solo se añade; retirar un campo es una v2 anunciada por escrito.
• Avisos firmados con HMAC-SHA256, marca de tiempo y llave de idempotencia, con reintentos con tope.
• Claves comparadas en tiempo constante, límite de uso por clave y acotación por mercados.
• Contratación previa registrada y operador identificado en cada servicio.
• Datos del pasajero solo donde hacen falta para prestar el viaje; los avisos de afiliados no los llevan.

Guías

• Inicio rápido: tu primer presupuesto en cinco minutosPide un precio con IVA, crea la reserva y consulta su estado con tres llamadas.
• Autenticación, claves y mercadosBearer o X-API-Key, dos clases de clave, mercados acotados y por qué la clave nunca va en el navegador.
• Precios para canales: público, neto o con descuentoQué devuelve `partner` según el modo de tu clave y los tres frenos que lo protegen.
• Errores, límites y reintentosQué significa cada código de estado, qué hacer con él y cómo reintentar sin duplicar.
• Avisos a tu sistema (webhooks) y cómo verificarlosEventos de reserva firmados con HMAC-SHA256, con llave de idempotencia y reintentos con tope.
• Asistentes de IA: el servidor MCPLas mismas herramientas de presupuesto y reserva para cualquier asistente, por JSON-RPC 2.0.
• Feed de rutas y precios para marketplacesCSV, JSON o XML con el precio de tu clave, quién lo sostiene y la antelación mínima.
• Sin programar: widget, botón y enlaces atribuidosDos líneas de HTML para poner el calculador en tu web, con la reserva atribuida a tu cuenta.
• Seguridad, datos personales y cumplimientoQué datos viajan, quién es responsable de qué y qué deja registrado la contratación previa.
• API, feed y avisos del afiliadoTu clave afi_, tus cifras, tus enlaces, el feed atribuido con token y los avisos firmados de cada conversión.
• Clave de pruebas: integra antes de firmarUna clave sbx_ al momento: presupuesto real, altas y cambios simulados, 30 días y sin tocar nada real.
• Versionado, cambios y soporteQué es un cambio compatible, cómo se anuncia uno que no lo es y dónde pedir ayuda.

Preguntas frecuentes

¿Quién presta el servicio que reservo por la API?

Un operador con autorización de vehículo con conductor o licencia de taxi, con contratación previa registrada. Si en una punta de demanda lo presta un operador adherido, se hace con su propia autorización y se dice quién lo presta.

¿El precio de la API es el mismo que el de la web?

Sí. El presupuesto usa el mismo cálculo que la web y es el que se cobra al reservar. Para canales que revenden, la respuesta añade el precio de canal (neto o con descuento) según lo pactado, sin cambiar lo que paga el pasajero.

¿Cómo se paga el uso de la API?

La relación es por servicio prestado: el canal revende a tarifa neta y pone su margen, o reservamos a precio público y se liquida una comisión. Las condiciones se pactan por escrito al emitir la clave.

¿Puedo probar antes de tener clave?

El catálogo de rutas, los productos turísticos, los mercados, la especificación OpenAPI y el precio orientativo de cualquier trayecto son públicos y sin clave. La reserva necesita una clave emitida para tu empresa.

¿Hay servidor MCP para asistentes de IA?

Sí. POST /api/mcp expone presupuesto, comprobación de horario, alta de la solicitud y consulta del servicio con el teléfono de la reserva, con la misma clave y el mismo límite que la API.