Primeros pasos con la API de actividades de Xeni
La API de Actividades de Xeni le brinda acceso programático a un inventario global de tours, atracciones, traslados y experiencias. Con una única integración, puede buscar destinos, explorar categorías de actividades, verificar la disponibilidad en tiempo real y completar reservas completamente a través de API.
Qué puedes hacer
La API de actividades v1 admite el ciclo de vida completo de la reserva:
- Buscar destinos: complete automáticamente los nombres de ciudades y destinos para recuperar ID de destino para consultas posteriores.
- Buscar etiquetas y categorías: recupere etiquetas de filtro disponibles (por ejemplo, recorridos en helicóptero, cruceros de un día, recorridos a pie) para cualquier destino.
- Buscar actividades: consulta actividades disponibles con filtros por precio, duración, hora del día, popularidad, ofertas especiales y etiquetas.
- Obtener detalles de la actividad: recupere información completa de la actividad, incluidas descripciones, ubicaciones, fechas disponibles y precios.
- Consultar disponibilidad: vea las opciones de productos disponibles con precios en tiempo real para fechas específicas y recuentos de viajeros.
- Reservar actividades: cree reservas con detalles del viajero, preguntas sobre reservas y preferencias de guía de idiomas.
- Administrar reservas: recupere los detalles de la reserva, verifique las penalizaciones por cancelación y procese cancelaciones.
Flujo de integración
Una integración típica sigue esta secuencia:
- Autocompletar un nombre de destino para obtener un
destinationId. - Obtenga etiquetas para que el destino presente opciones de filtrado a los usuarios.
- Buscar actividades utilizando el ID de destino, etiquetas y otros filtros.
- Obtenga detalles de una actividad seleccionada utilizando su
productCode. - Consulte disponibilidad para la fecha de viaje deseada y la combinación de viajeros.
- Reserve la actividad enviando la información del viajero y las respuestas a las preguntas sobre la reserva.
- Recuperar o cancelar la reserva según sea necesario.
Autenticación
Todas las solicitudes a la API de actividades requieren una clave API válida pasada en el encabezado de la solicitud:
| Encabezado | Requerido | Descripción |
|---|---|---|
x-api-key | Sí | Su clave API de Xeni. |
Incluya este encabezado en cada solicitud. Si no tiene una clave API, comuníquese con su administrador de cuentas Xeni o comuníquese con customersupport@xeni.com.
URL base
Todos los puntos finales de actividad utilizan la siguiente ruta base:
{{api_host}}/api/ext/activity/...
Reemplace {{api_host}} con la URL del entorno adecuada proporcionada durante la incorporación.
Puntos finales disponibles
| Método | Punto final | Descripción |
|---|---|---|
| PUBLICAR | /api/ext/activity/destinations | Autocompletar nombres de destinos |
| OBTENER | /api/ext/activity/tags | Obtener etiquetas de filtro para un destino |
| PUBLICAR | /api/ext/activity/search | Buscar actividades con filtros |
| OBTENER | /api/ext/activity/details/{productCode} | Obtener detalles de la actividad |
| PUBLICAR | /api/ext/activity/availability | Consultar disponibilidad y precios |
| PUBLICAR | /api/ext/activity/booking | Reserva una actividad |
| OBTENER | /api/ext/activity/bookings/{bookingId} | Recuperar detalles de la reserva |
| OBTENER | /api/ext/activity/{bookingId}/cancel-penalty | Penalización por cancelación de cheques |
| PUBLICAR | /api/ext/activity/cancel | Cancelar una reserva |
Próximos pasos
Comience buscando destinos utilizando el punto final de autocompletar. Consulte Cómo buscar destinos de actividades para obtener un tutorial paso a paso.