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
- Producto: Una actividad reservable (lo que muestras y vendes).
- Grupo de productos: Conjunto de productos similares.
- La experiencia: Un envoltorio conceptual/de marketing que puede contener varios productos.
- Entradas: Tipos de entradas para un producto (adulto/niño/infantil, etc.).
- Itinerario: Una reserva (reserva de actividad) con un producto.
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 lo que puedes vender en un destino y crea un catálogo estructurado de actividades por destino listas para comercializar.
- Asigna regiones al inventario subyacente (experiencias, grupos de productos y productos).
- Extrae contenido enriquecido de las actividades (títulos, descripciones, imágenes, ubicaciones y etiquetas) en varios idiomas.
- Utilízalo para rellenar los resultados de la búsqueda, las páginas de detalles de las actividades y los filtros (e.g., "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 productos y fechas específicos, solicita disponibilidad y precios por tipo de billete.
- Muestra calendarios (fechas disponibles/no disponibles), franjas horarias y precios
fromen la experiencia del comprador. - Admite varios productos y monedas en una sola llamada.
Paso 3: Pre-booking comprobación de precios
Confirma el precio final reservable y los requisitos 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.
- Revalida una selección específica (producto, 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 una lista de campos de reserva obligatorios (e.g., datos del pasajero, pick-up tipo) 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, el token de pago y los datos del viajero (viajero principal y viajeros 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 tu referencia de afiliado.
- Anular las reservas cuando esté permitido y comunicar al cliente el estado resultante.
- Recupera los documentos de los vales para que los clientes los presenten en la actividad.
Resumen de puntos finales por caso de uso
| Caso práctico | Método y camino | Notas/parámetros clave |
|---|---|---|
| Region-to-inventory cartografía | GET /activities/regions/{region_id} | include[]=experience_ids/product_group_ids/product_ids |
| Contenido de la experiencia | GET /activities/experiences/content | experience_id[], language, filtros de etiquetas opcionales |
| Contenido del grupo de productos | GET /activities/product_groups/content | product_group_id[], language, filtros de etiquetas opcionales |
| Contenido del producto | GET /activities/products/content | product_id[], language |
| Horario de apertura de los productos | GET /activities/products/{product_id}/open_times | start_date, end_date (≤ 90 días),language |
| Etiquetas: | GET /activities/references/tags | pagination_size, language |
| Tipos de etiquetas | GET /activities/references/tag_types | language |
| Comentarios de los huéspedes | GET /activities/products/{product_id}/guest-reviews | language, pagination_size |
| Disponibilidad y precios | GET /activities/availability | product_id[], start_date, end_date (≤14), currency, language |
| Disponibilidad en tu calendario | GET /activities/calendars/availability | product_id[], start_date,end_date |
| Comprobación de los precios | GET /activities/products/{product_id}/price-check | token, tickets |
| Creación de una reserva | POST /itineraries/activity | Ficha de consulta; cuerpo CreateItineraryRequest |
| Recuperar por id de itinerario | GET /itineraries/{itinerary_id}/activity | Detalles completos y enlaces para cancelar/voucher |
| Recuperar por referencia de afiliado | GET /itineraries/activity | Consulta affiliate_reference_id |
| Cancelación de la reserva | DELETE /itineraries/{itinerary_id}/activity | • 204 = cancelado • 202 = estado desconocido |
| Recuperar bono | GET /itineraries/{itinerary_id}/activity/voucher | Devuelve el enlace del vale |
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 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.