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 Activities 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 de « 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 ») debe ser un número entero mayor o igual que 0.
Paso 2: Consulta la disponibilidad y los precios
Averigua cuándo hay actividades disponibles y a qué precio. Aprovecha las fechas y horarios 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 por 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: Comprobación de 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 realizar el pago. 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 las existencias agotadas).
- 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 del 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 poder 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 generar vales para las reservas existentes.
- Consulta los datos de la reserva por el ID del itinerario o por 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.
Marketing comisión y beneficio bruto
Con la API de Rapid Activities, puedes consultar las estimaciones de marketing_fee y gross_profit para saber cuáles son los ingresos previstos de una transacción.
marketing_feeSon los ingresos estimados de tu socio por la transacción: la parte del beneficio bruto calculada previamente según tus condiciones comerciales con Expedia Groupgross_profitEs el beneficio total estimado que se repartirá entre tú y Expedia Group;. Si lo prefieres, puedes usar este campo en lugar demarketing_feepara aplicar tu propia lógica de niveles.
Ambos campos aparecen en las respuestas de «Disponibilidad», «Consulta de precios» y «Recuperar», y se vuelven a calcular en la «Consulta de precios» para reflejar cualquier cambio en los precios que se haya producido desde que se determinó la disponibilidad. La respuesta «Retrieve» refleja el estado financiero más reciente de la reserva, así que sus valores pueden diferir de los que se mostraban en «Price Check» si ese estado ha cambiado.
Si tu implementación de Rapid API tiene activada la función «Affiliate Collect» de Expedia (EAC) ), también verás « marketing_fee_eac » en las respuestas de disponibilidad y consulta de precios. Esto representa los ingresos estimados específicos de la vía de pago « EAC ». La respuesta «Retrieve» devuelve el campo que coincida con la ruta de pago que se haya utilizado realmente para completar la reserva.
Puedes configurar el acceso a estos tres parámetros si lo deseas; ponte en contacto con tu gestor de cuentas si quieres que se active esta opción.
Tarifas reembolsables
La API de Rapid Activities permite filtrar 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 con derecho a reembolso
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 política 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=25Notificaciones
La API de Rapid Activities ahora admite notificaciones push para eventos que afectan a las reservas, así que tus sistemas pueden mantenerse sincronizados con Rapid API sin necesidad de realizar consultas periódicas.
>> Más información sobre las notificaciones
Probar 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 un encabezado 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 erróneo) | Error |
invalid_input | 400 solicitud incorrecta (datos de entrada no válidos) | 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 (datos de entrada no válidos) | 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, a continuación, usa un programa de pruebas como Postman para ver cómo se comparan los ejemplos y las definiciones de esquemas con los resultados reales. Cuando esta API haya superado la fase piloto, sus puntos de conexión también se incluirán en nuestro API Explorer.