Visión general de la API Rapid Car
Habilita reservas sólidas de coches de alquiler en end-to-end
El paquete API para coches
La API de Rapid Car permite hacer reservas de alquiler de coches en end-to-end con el impresionante inventario de coches de alquiler de Expedia Group's, creando una experiencia más holística para los viajeros. Con acceso a 47.000 proveedores en más de 190 países, los socios pueden ampliar significativamente sus ofertas y aumentar las reservas. El diseño modular de nuestra API te permite personalizar fácilmente el proceso de reserva de los viajeros para adaptarlo a las necesidades de tu empresa.
Nuestros puntos finales proporcionan a los desarrolladores un acceso completo a los servicios de alquiler de coches, permitiendo funciones como buscar coches disponibles en todas las ubicaciones, ver los detalles de los precios y los extras disponibles, registrar métodos de pago, crear reservas, recuperar detalles de las reservas y realizar cancelaciones. Consulta a continuación una vista general del flujo /cars:
Conoce los puntos finales
Dado que este producto se encuentra aún en fase de acceso temprano, ten en cuenta que los detalles del esquema y la funcionalidad están aún en desarrollo activo y pueden cambiar antes de la publicación completa de este producto a los socios.
| Acción | Method | URI REST | Resultado |
|---|---|---|---|
| Buscar coches | GET | /cars/availability | Devuelve los distintos coches de alquiler disponibles en función de varios criterios, e.g. pick-up, drop-off, y radio de búsqueda, con un máximo de 200 coches por solicitud. La respuesta incluye detalles como el ID del coche de alquiler, pick-up/drop-off localizaciones, tipo de coche, kilometraje y más. |
| Mira los detalles | GET | /cars/{car_rental_id}/details | Devuelve los detalles de un coche concreto, incluyendo un desglose de precios, extras opcionales y pólizas. |
| Registra un método de pago para la reserva | POST | /payments | Devuelve un token de pago que irá en el cuerpo de la solicitud de creación de reserva. Este punto final no es el mismo que en otras API. |
| Haz la reserva | POST | /itineraries/car | Completa el proceso de reserva. |
| Recupera la reserva. | GET | /itineraries/car | Devuelve los detalles de una reserva por affiliate_reference. |
| Recuperar el itinerario | GET | /itineraries/{itinerary_id}/car | Devuelve los detalles del itinerario por itinerary_id. |
| Cancelación de una reserva | DELETE | /itineraries/{itinerary_id}/car | Cancela una reserva existente. |
Caso práctico
A continuación te explicamos cómo puedes utilizar la API de Rapid Car para crear una experiencia de reserva en end-to-end.
Paso 1: Busca el coche perfecto
Utiliza /cars/availabilitypara que los clientes puedan buscar vehículos disponibles según su ubicación y fechas.
Nota: El número máximo de resultados que se devolverán es 200.
| Parámetro clave | Descripción | Recomendación |
|---|---|---|
pickup_time | La hora de recogida del coche de alquiler. | Dado en formato ISO 8601 ampliado, e.g. 2018-02-12T11:59:00.000Z |
dropoff_time | La hora de entrega del coche de alquiler. | Dado en formato ISO 8601 ampliado, e.g. 2018-02-12T11:59:00.000Z |
pickup_area | La ubicación de recogida del coche se da como un radio y unas coordenadas. | El formato es radius,latitude,longitude, e.g. 10,37.9838,23.7275. Sólo se requiere uno de pickup_areao pickup_airport. |
dropoff_area | El lugar de entrega del coche se indica en forma de radio y coordenadas. | El formato es radius,latitude,longitude, e.g. 10,37.9838,23.7275. Sólo se permite una de dropoff_areao dropoff_airport. |
pickup_airport | El aeropuerto donde se recogerá el coche. | Sólo se requiere uno de pickup_areao pickup_airport. |
dropoff_airport | El aeropuerto donde se dejará el coche. | Sólo se permite una de dropoff_areao dropoff_airport. |
driver_age | La edad del conductor, si es menor de 30 años o mayor de 70. | Debe utilizarse un valor por defecto de 40, a menos que se indique que la edad del conductor está fuera de estos parámetros. |
currency | La moneda deseada para los tipos. | Dado en formato ISO 4217, e.g. USD. |
language | La lengua deseada para la respuesta. | Utiliza sólo códigos de idioma ISO639-1 alfa 2. Consulta esta lista para obtener más información. |
country_code | El código de país del punto de venta del viajero. | En formato ISO 3166-1 alfa-2. Debe representar el país en el que se realiza la transacción. |
rental_company | Permite filtrar por empresa de alquiler. | Se puede especificar un máximo de 20 empresas de alquiler repitiendo varias veces el parámetro de consulta rental_company. |
Paso 2: Obtener detalles
Utiliza el punto final /cars/{car_rental_id}/detailspara recuperar información adicional sobre el vehículo, incluido el desglose de precios y las políticas.
Paso 3: Obtener información del cliente sobre el método de pago elegido
Ahora puedes utilizar el punto final paymentspara 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 4: Crear la reserva
La respuesta /cars/{car_rental_id}/detailsdevuelve un enlace para completar la sesión de pago y crear una reserva. El punto final /itineraries/carpermite completar la reserva.
Paso 5: Recuperar la reserva
Para recuperar los detalles de la reserva, llama al punto final /itineraries/{itinerary_id}/carpara obtener tu ID de confirmación.