API de alquiler de coches: introducción
La API v2 de Xeni Car Rental le permite buscar autos de alquiler en todo el mundo, recuperar información detallada del vehículo y su ubicación, crear reservas y administrar reservas. Esta guía cubre los elementos esenciales que necesita para comenzar a integrarse.
URL base
Todos los puntos finales de Car Rental API v2 comparten la siguiente ruta base:
{{api_host}}/cars/api/v2/
Reemplace {{api_host}} con el host específico del entorno proporcionado durante la incorporación.
Autenticación
Cada solicitud debe incluir una firma válida en el encabezado Authorization. Consulte el artículo Autenticación y firmas API para obtener instrucciones sobre cómo generar y actualizar firmas.
Encabezados requeridos
Incluya los siguientes encabezados con cada solicitud:
| Encabezado | Descripción |
|---|---|
Authorization | Su firma API generada (token de portador). |
x-api-key | Su clave API única, proporcionada durante la incorporación. |
x-correlation-id | Un identificador único (UUID) para la solicitud, que se utiliza para el seguimiento y la depuración. |
El flujo de reserva completo
Una integración típica de alquiler de automóviles sigue un flujo de seis pasos. Cada paso se basa en los datos devueltos por el anterior.
Paso 1: Autocompletar ubicación de recogida
Utilice el punto final Autocompletar para permitir a los usuarios buscar ubicaciones de recogida y devolución por nombre. El punto final devuelve ciudades y aeropuertos junto con las coordenadas geográficas que pasarás en la búsqueda.
GET /cars/api/v2/autocomplete?key=new yo
Paso 2: Buscar alquileres disponibles
Pase las coordenadas del resultado de autocompletar al punto final Buscar alquileres junto con las fechas de recogida y devolución. La API devuelve una lista paginada de vehículos disponibles con precios.
GET /cars/api/v2/rentals?country=US&pickupdate=2026-06-15T10:00:00&returndate=2026-06-20T10:00:00&pickuptype=geo&returntype=geo&pickupcode=40.7128,-74.006&returncode=40.7128,-74.006¤cy=USD
Paso 3: Aplicar filtros (opcional)
Limite los resultados utilizando parámetros de filtro como tipo de vehículo, rango de precios, transmisión y más. Los filtros utilizan una sintaxis field:operator:value.
GET /cars/api/v2/rentals?...&filter=vehicle_type:in:SUV,price:lte:100
Paso 4: Obtenga detalles del alquiler
Una vez que el usuario seleccione un vehículo, llame al punto final Detalles del alquiler con el token de disponibilidad. Esto devuelve complementos de equipo, detalles de ubicación, horarios de atención y términos del proveedor.
GET /cars/api/v2/rental/details?country=US¤cy=USD&availability_token={token}
Paso 5: Crear una reserva
Envíe la reserva con los detalles del cliente, conductores adicionales opcionales y complementos de equipo seleccionados.
POST /cars/api/v2/bookings?currency=USD
Paso 6: Recuperar o Cancelar
Utilice el ID de reserva para recuperar los detalles de la reserva en cualquier momento o cancelar la reserva si es necesario.
GET /cars/api/v2/bookings/{booking_id}
PATCH /cars/api/v2/bookings/{bookingid}?token={bookingtoken}
¿Qué sigue?
- Cómo buscar ubicaciones de recogida: aprenda a utilizar el punto final de autocompletar.
- Cómo buscar autos de alquiler disponibles: cree su primera solicitud de búsqueda de alquiler.
- Cómo utilizar los filtros de búsqueda de alquiler de coches: filtra y ordena los resultados.
- Cómo obtener detalles del vehículo de alquiler y complementos de equipo: recupera los detalles completos del vehículo.
- Cómo reservar un alquiler de coche: crea una reserva.
- Cómo recuperar o cancelar una reserva de alquiler de coche: gestiona las reservas existentes.
- API de alquiler de automóviles: comprensión de los campos de respuesta: referencia para códigos SIPP, tipos de vehículos y estructuras de tarifas.