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
- Actividad: Un evento reservable (lo que muestras y vendes).
- Grupo de actividades: Conjunto de actividades similares.
- Experiencia: Una envoltura conceptual/de marketing que puede contener múltiples actividades.
- Entradas: Tipos de entradas 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 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 saltarse 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 de la API de Geografía 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, visitas para familias o 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, 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 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 dará lugar a un mensaje de respuesta estático, por lo que las tasas y el contenido devuelto 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 |
invalid_input | 400 solicitud errónea (entrada no válida) | Error |
bad_link | 400 solicitud incorrecta (enlace incorrecto) | 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 |
invalid_input | 400 solicitud incorrecta (entrada no válida) | Error |
bad_link | 400 solicitud incorrecta (enlace incorrecto) | Error |
price_mismatch | 409 conflicto (desajuste de precios) | Error |
sold_out | 409 conflictos (agotado) | Error |
internal_server_error | 500 error interno del servidor (error desconocido) | Error |
service_unavailable | 503 servicio no disponible | Error |
Resumen de puntos finales por caso de uso
| Caso práctico | Método y camino | Parámetros de consulta requeridos / comentarios |
|---|---|---|
| Experiencias regionales | GET /regions/{region_id}/experiences | language |
| Grupos de actividad de la región | GET /regions/{region_id}/activity-groups | language |
| Actividades regionales | GET /regions/{region_id}/activities | language |
| Contenido de la experiencia | GET /experiences/content | experience_id[], language |
| Contenido del grupo de actividad | GET /experiences/activity-groups/content | language, activity_group_id[] |
| Contenido de la actividad | GET /experiences/activities/content | activity_id[], language |
| Horario de funcionamiento de la actividad | GET /experiences/activities/{activity_id}/operating-hours | start_date, end_date (≤ 90 días),language |
| Categorías de experiencia | GET /experiences/categories | language, pagination_size |
| Atributos de la experiencia | GET /experiences/attributes | language, pagination_size |
| Categorías de actividades | GET /experiences/activities/categories | language, pagination_size |
| Atributos de la actividad | GET /experiences/activities/attributes | language, pagination_size |
| Comentarios de los huéspedes | GET /experiences/activities/{activity_id}/guest-reviews | limit, sort |
| Disponibilidad y precios | GET /experiences/activities/availability | activity_id[], start_date, end_date (≤14), currency,language |
| Disponibilidad en tu calendario | GET /experiences/activities/calendars/availability | activity_id[], start_date,end_date |
| Comprobación de los precios | GET /experiences/activities/{activity_id}/price-check | token (de la llamada a la API de Compras), tickets |
| Creación de una reserva | POST /itineraries/activity | Consulta: token (de la llamada a la API de Compras), Cuerpo: CreateItineraryRequest, affiliate_reference_id, payment_token,primary_traveler |
| Recuperar por ID de itinerario | GET /itineraries/{itinerary_id}/activity | — |
| Recuperar por referencia de afiliado | GET /itineraries/activity | affiliate_reference_id |
| Cancelación de la reserva | DELETE /itineraries/{itinerary_id}/activity | 204(reserva cancelada con éxito), 202 (estado desconocido) |
| Recuperar bono | GET /itineraries/{itinerary_id}/activity/voucher | Devuelve el enlace para recuperar el bono de la actividad reservada |
Nota: Los parámetros que van seguidos de []indican que puede tener varios valores en una matriz comma-separated.
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.