Visión general de la API de Actividades Rápidas
Permite a tus clientes reservar cosas auténticas que hacer 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 cuarto 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.
La API de Actividades Rápidas está diseñada para ayudarte a presentar actividades y experiencias a los viajeros a través de una vía de reserva fácil de integrar end-to-end. Esto proporciona a los viajeros una experiencia de reserva más holística, a la vez que te permite desbloquear nuevas fuentes de ingresos.
Construir tu flujo de reservas de actividades
Los pasos que se describen a continuación ofrecen una visión general de la integración con la API de Actividades y la construcción de tu ruta de reserva. La API de Actividades Rápidas se compone de una selección de puntos finales que, juntos, permiten un flujo search-to-book.
Nota: Dado que este producto se encuentra todavía en la 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 del lanzamiento completo de este producto a los socios.
1. Buscar actividades disponibles
El punto final availability recupera las actividades y experiencias disponibles en función de una ubicación y un intervalo de fechas determinados.
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 |
2. Ver ofertas para una actividad elegida
El punto final offers proporciona al viajero más detalles sobre las ofertas disponibles para la actividad elegida, incluyendo horarios, precios y disponibilidad de visitas.
É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. |
3. Comprueba el precio y facilita los datos de pago
Una vez que el viajero ha encontrado la experiencia vacacional perfecta, utiliza el punto final offer_id para comprobar el precio y la información necesaria para la reserva.
4. Obtener información del viajero sobre la forma de pago elegida
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.
5. Crea la reserva
Utiliza el punto final activity para crear una reserva. Este punto final devolverá un itinerary_id con todos los enlaces de operación relevantes.
6. Recuperar datos de la reserva
Puedes utilizar el punto final 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.