Descripción general de la API de Rapid Activities
Ofrece a los viajeros la posibilidad de reservar actividades y experiencias con la API de Rapid Activities
Versión preliminar de acceso anticipado
Esta documentación forma parte de una iniciativa de acceso anticipado reservada exclusivamente a socios seleccionados. Los programas beta se pondrán en marcha en el tercer trimestre de 2026 y estarán disponibles para todo el mundo en 2027.
Si te interesa convertirte en socio beta, ponte en contacto con tu gestor de cuentas.
La API de Rapid Activities está diseñada para ayudarte a mostrar actividades a los viajeros a través de un proceso de compra y reserva « end-to-end » (de la página de inicio a la reserva) fácil de integrar. Esto ofrece a los viajeros una experiencia más completa y, al mismo tiempo, te permite acceder a nuevas fuentes de ingresos.
Conceptos clave
| Vigencia | Definición |
|---|---|
| Actividad | Un evento que se puede reservar (lo que muestras y vendes). |
| Grupo de actividades | Un conjunto de actividades similares. |
| Experiencia | Un marco conceptual o de marketing que puede incluir varias actividades. |
| Entradas | Tipos de reserva para una actividad (adulto/niño/bebé, etc.). |
| Itinerario | Una reserva (reserva de actividad) que incluye una actividad y una o más entradas. |
| Categorías | High-level grupos que clasifican las experiencias y actividades por temas (por ejemplo, visitas guiadas por la ciudad, museos o actividades al aire libre). |
| Atributos | Etiquetas descriptivas que reflejan características específicas de una experiencia o actividad (por ejemplo, «accesible en silla de ruedas», «ideal para familias», «visita guiada» o «sin colas»). |
Flujo de integración de principio a fin
La reserva de actividades con esta API sigue este proceso general.
Paso 1: Descubre el inventario
Empieza por crear un catálogo estructurado de actividades por destino que esté listo para su comercialización. Este catálogo te ayudará a saber qué productos puedes vender en esa zona.
Cómo crear un catálogo
- Asigna las regiones geográficas al inventario subyacente (experiencias, actividades y grupos de actividades) utilizando los puntos finales de region-mapping. Nota: La API de Actividades solo admitirá el parámetro
region_IDen esta versión.
>> Más información sobre las regiones 2. Recopila contenido enriquecido (títulos, descripciones, imágenes, ubicaciones y categorías) en varios idiomas. 3. Recopila valoraciones y opiniones de los huéspedes sobre las actividades para ayudar a los viajeros a comparar opciones y generar confianza en la experiencia. 4. Rellena los resultados de búsqueda, las páginas de detalles de las actividades y los filtros (por ejemplo, «apto para familias» o «rutas a pie»).
Filtrar por región y zona
Con la API de Rapid Activities puedes usar el parámetro de consulta « area » para filtrar los resultados y buscar dentro de la intersección de las zonas definidas por las coordenadas region_id y area. El objetivo es ayudarte a reducir la lógica de filtrado personalizada y mostrar a los viajeros actividades que puedan estar cerca de un punto concreto, como un hotel.
Para usar el filtro « area », incluye en él los campos « radius_km », « latitude » y « longitude », que definen el ámbito geográfico de las actividades que quieres que aparezcan.
Ejemplo de solicitud
GET /v2/regions/{region_id}/activity-groups?area=10,34.0512226,-118.2403994&pagination_size=25Nota: « radius_km » (el primer campo de « area ») tiene que ser un número entero mayor o igual que 0.
Paso 2: Busca disponibilidad y precios
Averigua cuándo se pueden hacer las actividades y a qué precio. Aprovecha las fechas y horas disponibles, las opciones de entradas y los rangos de precios para potenciar la experiencia de compra.
- Para conocer las actividades y fechas concretas, consulta la disponibilidad y los precios según el tipo de entrada.
- Muestra los calendarios (fechas disponibles/no disponibles), los horarios y los precios mínimos en la experiencia del comprador.
- Admite varias actividades en una sola llamada.
Paso 3: Comparar precios en Pre-booking
Confirma el precio final de la reserva y obtén una lista de los campos obligatorios de la reserva antes de pagar. Recibe una oferta confirmada y un código de reserva, de acuerdo con el inventario y las condiciones más recientes.
- Valida una selección concreta (actividad, fecha, hora y entradas) en tiempo real.
- Consulta el precio final, los impuestos y tasas, y el estado de disponibilidad (incluidos los cambios de precio o si se han agotado las existencias).
- Consigue información sobre los campos obligatorios de la reserva (como los datos de los pasajeros o el tipo de « pick-up ») y un token seguro para la reserva.
Paso 4: Crear una reserva
Convierte una selección confirmada en una reserva. Recibe un itinerario confirmado (reserva) que podrás visualizar y gestionar en tus propios sistemas.
- Envía el token de reserva desde el proceso de compra como parámetro de consulta y el «
payment_token» de la API de pagos en el cuerpo de la solicitud, junto con los datos de los viajeros (viajeros principales y adicionales). - Añade tu propio código de afiliado para que puedas cotejar y buscar las reservas más adelante.
- Recibirás un número de itinerario y unos enlaces para consultar los detalles de la reserva.
Paso 5: Gestionar las reservas
Ofrece apoyo en los procesos posteriores a la reserva tanto para los clientes como para los agentes. Accede a un conjunto completo de herramientas para después de la reserva con las que podrás consultar, cancelar y emitir vales para las reservas existentes.
- Consulta los detalles de la reserva por el ID del itinerario o tu referencia de afiliado.
- Cancela las reservas cuando esté permitido y comunica al cliente el estado resultante.
- Consigue los documentos de los vales para que los clientes los presenten en la actividad.
Tarifas reembolsables
La API de Rapid Activities permite filtrar las actividades según el atributo «Tarifa reembolsable» para indicar aquellas actividades que ofrecen un reembolso si se cancelan dentro del plazo de cancelación indicado. Esta función está pensada para ayudar a reducir la necesidad de crear lógicas de filtrado personalizadas y mostrar a los viajeros actividades que ofrezcan una política de cancelación más flexible.
Filtrar por actividades reembolsables
Usa el parámetro « attribute_id » con el ID de atributo 25 para las tarifas reembolsables.
GET /v2/regions/{region_id}/activities?attribute_id=25
Nota:. Deberías seguir utilizando la información sobre la póliza que aparece en la respuesta a la hora de mostrar las condiciones de cancelación a los viajeros.
Ejemplo de solicitud
GET /experiences/activities/content?language=en-US&activity_id=703295&activity_id=973888&activity_id=975441&activity_id=1006352&supported_booking_data_types=*&attribute_id=25Probar las respuestas de error
Para enviar una solicitud de prueba para un método concreto de la API de Rapid Activities, incluye un encabezado HTTP adicional llamado « test » en tu solicitud de Shopping o Booking y utiliza el valor adecuado de las tablas que aparecen a continuación. Si no envías un encabezado de prueba o envías uno que no sea válido, la solicitud se procesará en tiempo real.
Nota:. Si usas una cabecera de prueba, se mostrará un mensaje estático, por lo que es posible que las tarifas y el contenido que se muestren no sean relevantes para las actividades que se están probando.
API de compras y de contenido
| 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 | Error 500 del servidor interno (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 erróneo) | Error |
invalid_input | 400 Solicitud incorrecta (entrada no válida) | Error |
price_mismatch | 409: conflicto (discrepancia de precios) | Error |
sold_out | 410 conflicto (agotado) | Error |
internal_server_error | Error 500 del servidor interno (error desconocido) | Error |
service_unavailable | 503: servicio no disponible | Error |
Detalles de la API
Echa un vistazo a las definiciones de los puntos finales de activity-related en esta página y, después, usa un programa de pruebas como Postman para ver cómo se comparan los ejemplos y las definiciones de esquemas con el resultado real. Cuando esta API haya superado la fase piloto, sus puntos de conexión también se incluirán en nuestro API Explorer.