Documentación piloto de 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 tercer trimestre de 2025, y la disponibilidad general en 2026.
Si estás interesado en convertirte en socio piloto o beta, ponte en contacto con tu gestor de cuentas.
Pruebas recientes de sugieren que los viajeros buscan cada vez más las experiencias auténticas por encima de las posesiones materiales y, aunque esto ya era así pre-Covid,, lo es aún más en un mundo post-pandemic. La API de Actividades Rápidas está diseñada para ayudar a los socios a presentar actividades y experiencias a sus clientes a través de una vía de reserva fácil de integrar end-to-end. Esto permite a los clientes tener una experiencia de reserva más holística, así como desbloquear nuevas fuentes de ingresos para los socios.
El paquete API Rapid /actividades
Las Actividades Rápidas se componen de una selección de puntos finales que, juntos, permiten un flujo search-to-book.
Dado que este producto se encuentra todavía en fase de acceso temprano, ten en cuenta que los detalles del esquema y la funcionalidad están todavía en desarrollo activo y pueden cambiar antes de la publicación completa de este producto a los socios.
A continuación se indican los principales puntos finales implicados:
| Acción | Method | Resto URI | Resultado |
|---|---|---|---|
| Buscar actividades | GET | /actividades/disponibilidad | Recupera las actividades y experiencias disponibles en función de una ubicación y un intervalo de fechas determinados. |
| Mira los detalles | GET | /actividades/{activity_id}/offers | Busca ofertas para la actividad seleccionada. Devuelve los horarios y precios de las visitas guiadas, etc. disponibles para esa actividad concreta. |
| Confirmar precio | GET | /actividades/{activity_id}/offers/{offer_id} | Devuelve un precio resumido y los campos obligatorios de la reserva. |
| Registra un método de pago para la reserva | POST | /pagos | Registra un método de pago al hacer una reserva. La respuesta incluirá un payment_tokenque irá en el cuerpo de la solicitud de crear reserva. |
| Crear la reserva | POST | /itinerarios/actividad | Crea la reserva. Este punto final devolverá un itinerary_idcon los enlaces de operación pertinentes. |
| Solicitar detalles de una reserva existente por ID de itinerario | GET | /itinerarios/{itinerary_id}/activity | Devuelve los detalles del itinerario mediante el parámetro itinerary_id. |
| Solicitar detalles de una reserva existente por proveedor de actividades. | GET | /itinerarios/actividad | Devuelve los detalles de una reserva en función del parámetro affiliate_reference. |
| Cancelación de la reserva | Eliminar | /itinerarios/{itinerary_id}/activity | Cancela una reserva existente. |
Caso práctico
A continuación te explicamos cómo puedes utilizar la API de Actividades Rápidas para crear una experiencia de reserva en end-to-end para tus clientes.
Paso 1 - Buscar actividades y experiencias disponibles para el lugar deseado
Utiliza el punto final /actividades/disponibilidad para que los viajeros puedan ver qué actividades hay disponibles en su destino durante su estancia.
Echa un vistazo a los parámetros clave a continuación:
| Parámetro clave | Descripción | Recomendación |
|---|---|---|
start_date | La fecha de inicio de la búsqueda de actividades disponibles. | Utiliza el formato ISO 8601. Por ejemplo, 2018-02-12. |
end_date | La fecha de finalización de la búsqueda de actividades disponibles. | Utiliza el formato ISO 8601. Por ejemplo, 2018-02-12. |
currency | Moneda solicitada para las tarifas. | Utiliza el formato ISO 4217. Por ejemplo, USD. |
language | Lengua deseada para la respuesta. | Utiliza solamente códigos de idioma ISO 639-1 alfa 2 y códigos de país ISO 3166-1 alfa 2. |
country_code | El código de país del punto de venta del viajero. | Utiliza el formato ISO 3166-1 alfa-2. Este código debe representar el país en el que se realiza la transacción de compra. Por ejemplo, US. |
region_id | El lugar o la zona donde el viajero busca actividades. | Por ejemplo, 1122931. |
limit | El número máximo de actividades devueltas en la respuesta. | Máximo: 100 |
Paso 2 - Obtener detalles de las ofertas disponibles para la actividad deseada
Obtén más información para el cliente sobre las ofertas disponibles para la actividad seleccionada. El punto final /actividades/{activity_id}/offers devuelve los horarios y precios de cosas como las visitas guiadas disponibles para la actividad.
Éste es el tipo de detalles que los viajeros deben conocer antes de reservar:
| Punto de conexión | Úsalo para... |
|---|---|
callouts | Proporciona a los clientes información importante para que conozcan la actividad antes de reservarla. |
inclusions | Haz un resumen de todas las funciones incluidas en la actividad. |
exclusions | Proporciona una lista de las características no incluidas en la actividad. |
Paso 3 - Confirmar el precio y facilitar los datos de pago
Una vez que tu cliente haya encontrado la experiencia vacacional perfecta, utiliza el punto final /actividades/{activity_id}/offers/{offer_id} para validar el precio actual y la información necesaria para la reserva.
Paso 4 -Obtener información del cliente sobre el método de pago elegido
Ahora puedes utilizar el punto final /payments para permitir que el cliente registre un método de pago para la reserva. La respuesta contendrá un payment_token, que va en el cuerpo de la solicitud de crear reserva.
Paso 5 - Crear la reserva
Utiliza el punto final /itinerarios/actividad para crear una reserva. Este punto final devolverá un itinerary_idcon todos los enlaces de operación relevantes.
Paso 6 - Recuperar los datos de la reserva
Puedes utilizar el punto final /itineraries/{itinerary_id}/activity para recuperar los detalles de la reserva utilizando el ID del itinerario. La respuesta incluirá enlaces de cancelación, si procede.
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.