Visión general de la API de Actividades Rápidas
Permite a los viajeros reservar actividades y experiencias con la API de Actividades Rápidas
Acceso anticipado
Esta documentación forma parte de una iniciativa de acceso anticipado sólo para socios seleccionados. Los programas piloto se pondrán en marcha en el segundo trimestre de 2026, y la disponibilidad general en 2027.
Si estás interesado en convertirte en socio piloto o beta, ponte en contacto con tu gestor de cuentas.
La API de Actividades Rápidas está diseñada para ayudarte a presentar actividades a los viajeros a través de un flujo de compras y reservas fácil de integrar, end-to-end. Esto proporciona a los viajeros una experiencia más holística a la vez que te permite desbloquear nuevas fuentes de ingresos.
Conceptos clave
| Vigencia | Definición |
|---|---|
| Actividad | Un evento reservable (lo que muestras y vendes). |
| Grupo de actividad | Un conjunto de actividades similares. |
| Experiencia | Una envoltura conceptual/de marketing que puede contener múltiples actividades. |
| Entradas | Tipos de reserva para una actividad (adulto/niño/infantil, etc.). |
| Itinerario | Una reserva (reserva de actividad) con una actividad y una o más entradas. |
| Categorías | High-level Agrupaciones que clasifican las experiencias y actividades en temas (por ejemplo, visitas a ciudades, museos o actividades al aire libre). |
| Atributos | Banderas descriptivas que captan características específicas de una experiencia o actividad (por ejemplo, accesible en silla de ruedas, "apta para familias", "visita guiada" o "sáltate la cola"). |
Flujo de integración de extremo a extremo
La reserva de actividades con esta API sigue este flujo general.
Paso 1: Descubre el inventario
Comprende qué puedes vender en un destino y crea un catálogo estructurado de actividades por destino listas para comercializar.
- Mapea las regiones al inventario subyacente (experiencias, actividades y grupos de actividades) utilizando los puntos finales de mapeo de regiones. Nota: La API de Actividades sólo admitirá el parámetro
region_IDen esta iteración. - Extrae contenido enriquecido de las actividades (títulos, descripciones, imágenes, ubicaciones y categorías) en varios idiomas.
- Obtén valoraciones y reseñas de los huéspedes sobre las actividades para ayudar a los viajeros a comparar opciones y generar confianza en la experiencia.
- Rellena los resultados de la búsqueda, las páginas de detalles de las actividades y los filtros (por ejemplo, "apto para familias" o "recorridos a pie").
Paso 2: Buscar disponibilidad y precios
Conoce cuándo hay actividades disponibles y a qué precio. Aprovecha las fechas y horas de reserva, las opciones de billetes y los rangos de precios para impulsar el proceso de compra.
- Para actividades y fechas concretas, solicita disponibilidad y precios por tipo de entrada.
- Muestra calendarios (fechas disponibles/no disponibles), franjas horarias y precios iniciales en la experiencia del comprador.
- Realiza varias actividades en una sola llamada.
Paso 3: Pre-booking comprobación de precios
Confirma el precio final reservable y obtén una lista de los campos obligatorios de la reserva antes del pago. Recibe una oferta confirmada y una ficha de reserva, en consonancia con el inventario y la política más recientes.
- Valida una selección específica (actividad, fecha, hora y tickets) en tiempo real.
- Recibe el precio final, los impuestos/tarifas y el estado de disponibilidad (incluidos los cambios de precio o las entradas agotadas).
- Obtén información sobre los campos obligatorios de la reserva (como los datos del pasajero o el tipo de pick-up ) y un token seguro para la reserva.
Paso 4: Crear reserva
Convierte una selección confirmada en una reserva. Recibe un itinerario confirmado (reserva) que puedes mostrar y gestionar en tus propios sistemas.
- Envía el token de reserva del flujo de compra como parámetro de consulta y el
payment_tokende la API de Pagos en el cuerpo de la solicitud junto con los detalles del viajero (viajero principal y adicionales). - Incluye tu propia referencia de afiliado para que puedas conciliar y buscar reservas más adelante.
- Recibe un ID de itinerario y enlaces para recuperar los detalles de la reserva.
Paso 5: Gestionar las reservas
Apoya los flujos de trabajo posteriores a la reserva para clientes y agentes. Accede a un completo conjunto de herramientas posteriores a la reserva para ver, cancelar y proporcionar vales para las reservas existentes.
- Recupera los detalles de la reserva por ID de itinerario o por tu referencia de afiliado.
- Anula las reservas cuando esté permitido y muestra el estado resultante al cliente.
- Recupera los documentos de los vales para que los clientes los presenten en la actividad.
Comprobación de respuestas de error
Para enviar una solicitud de prueba para un determinado método de la API de Actividades Rápidas, incluye una cabecera HTTP adicional llamada testen tu solicitud de Compra o Reserva y utiliza el valor apropiado de las tablas que aparecen a continuación. No enviar una cabecera de prueba o enviar una cabecera de prueba no válida hará que la solicitud se procese en directo.
Nota: El uso de una cabecera de prueba devolverá un mensaje estático, por lo que las tasas y el contenido devueltos pueden no ser relevantes para las actividades que se están probando.
API de compras y contenidos
| Valor del encabezado de prueba | Código HTTP y respuesta | Estado |
|---|---|---|
| Estándar | 200 OK (respuesta estándar de éxito) | Correcto |
bad_link | 400 solicitud incorrecta (enlace incorrecto) | Error |
invalid_input | 400 solicitud incorrecta (entrada no válida) | Error |
internal_server_error | 500 error interno del servidor (error desconocido) | Error |
service_unavailable | 503 servicio no disponible | Error |
API de reservas
| Valor del encabezado de prueba | Código HTTP y respuesta | Estado |
|---|---|---|
| Estándar | 200 OK (respuesta estándar de éxito) | Correcto |
bad_link | 400 solicitud incorrecta (enlace incorrecto) | Error |
invalid_input | 400 solicitud incorrecta (entrada no válida) | Error |
price_mismatch | 409 conflicto (desajuste de precios) | Error |
sold_out | 410 conflicto (agotado) | Error |
internal_server_error | 500 error interno del servidor (error desconocido) | Error |
service_unavailable | 503 servicio no disponible | Error |
Detalles de la API
Explora las definiciones de los puntos finales de activity-related en esta página, y luego utiliza un software de pruebas como Postman para saber cómo se comparan los ejemplos y las definiciones de los esquemas con la salida real. Cuando esta API supere la fase piloto, sus puntos finales se incluirán también en nuestra API Explorer.