Descripción general de la API de Rapid Car
Haz que las reservas de coches de alquiler en end-to-end sean fiables
El paquete Car API
La API de Rapid Car permite realizar reservas de alquiler de coches en end-to-end gracias al impresionante catálogo de vehículos de Expedia Group's, lo que ofrece una experiencia más completa a los viajeros. Con acceso a 47 000 proveedores en más de 190 países, los socios pueden ampliar considerablemente su oferta 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 de conexión ofrecen a los desarrolladores un acceso completo a los servicios de alquiler de coches, lo que permite realizar acciones como buscar coches disponibles en todas las oficinas, consultar los detalles de los precios y los extras disponibles, registrar formas de pago, crear reservas, consultar los detalles de las reservas y realizar cancelaciones.
Interacciones de los viajeros con la API de Car
Conoce los puntos finales
Como este producto todavía está en la fase de acceso anticipado, ten en cuenta que los detalles del esquema y las funcionalidades aún se están desarrollando y pueden cambiar antes del lanzamiento completo del producto para los socios.
| Acción | Method | URI REST | Resultado |
|---|---|---|---|
| Buscar coches | GET | /cars/availability | Muestra los distintos coches de alquiler disponibles según varios criterios, como « e.g. pick-up, drop-off, » y el radio de búsqueda, con un máximo de 200 coches por solicitud. La respuesta incluye datos como el número de reserva del coche de alquiler, pick-up/drop-off las oficinas, el tipo de coche, el kilometraje y mucho más. |
| Echa un vistazo a los detalles | GET | /cars/{car_rental_id}/details | Muestra los detalles de un coche concreto, incluyendo el desglose del precio, los extras opcionales y las condiciones. |
| Añade una forma de pago para la reserva | POST | /payments | Devuelve un token de pago que luego se incluirá 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 | Finaliza el proceso de reserva. |
| Recupera la reserva. | GET | /itineraries/car | Muestra los detalles de una reserva realizada por affiliate_reference. |
| Consulta el itinerario | GET | /itineraries/{itinerary_id}/car | Muestra los detalles del itinerario por itinerary_id. |
| Cancelación de una reserva | DELETE | /itineraries/{itinerary_id}/car | Cancela una reserva existente. |
Funcionamiento
A continuación te explicamos cómo puedes utilizar la API de Rapid Car para crear una experiencia de reserva « end-to-end ».
Paso 1: Busca el coche perfecto
Usa /cars/availability para que los clientes puedan buscar los vehículos disponibles según su ubicación y las fechas que elijan.
Nota: El número máximo de resultados que se mostrarán es 200.
| Parámetro clave | Descripción | Recomendación |
|---|---|---|
pickup_time | La hora de recogida del coche de alquiler. | En formato ISO 8601 ampliado: e.g. 2027-02-12T11:59:00 |
dropoff_time | La hora de devolución del coche de alquiler. | En formato ISO 8601 ampliado: e.g. 2027-02-12T11:59:00 |
pickup_area | La ubicación de recogida del coche se indica mediante un radio y unas coordenadas. | El formato es radius,latitude,longitude, e.g. 10,37.9838,23.7275. Solo necesitas una de estas dos direcciones: pickup_area o pickup_airport. |
dropoff_area | El lugar donde dejar el coche se indica mediante un radio y unas coordenadas. | El formato es radius,latitude,longitude, e.g. 10,37.9838,23.7275. Solo se permite una de estas direcciones: dropoff_area o dropoff_airport. te informo |
pickup_airport | El aeropuerto donde se recogerá el coche. | Solo necesitas una de estas dos direcciones: pickup_area o pickup_airport. |
dropoff_airport | El aeropuerto donde se va a dejar el coche. | Solo se permite una de estas direcciones: dropoff_area o dropoff_airport. te informo |
driver_age | La edad del conductor, si tiene menos de 30 años o más de 70. | Te sugerimos un valor por defecto de 40 cuando la edad del conductor no sea inferior a 30 ni superior a 70, a menos que en tu jurisdicción haya algún requisito específico. |
currency | La moneda en la que quieres ver las tarifas. | En formato ISO 4217: e.g. USD. |
language | El idioma en el que quieres recibir la respuesta. | El formato de idioma debe incluir un código de idioma de dos letras según la norma ISO 639-1, más el código de configuración regional de dos letras BCP-47. >> Ver todos los idiomas compatibles con Rapid |
country_code | El código de país del punto de venta del viajero. | Se indica en formato ISO 3166-1 alfa-2. Esto debería indicar el país en el que se realiza la transacción. |
traffic_profile | La versión de tu sitio (por ejemplo, web o aplicación) que se ha utilizado para la búsqueda | Te ayudaremos a configurar este valor de cadena cuando configures tu sitio web. |
Paso 2: Consulta los detalles
Usa el punto final /cars/{car_rental_id}/details para obtener información adicional sobre el vehículo, como el desglose del precio y las pólizas.
Paso 3: Pide al cliente que te facilite los datos del método de pago que haya elegido
Ahora puedes usar el punto final payments para que el cliente pueda registrar un método de pago para la reserva.
La respuesta incluirá un « payment_token », que se debe incluir en el cuerpo de la solicitud de creación de reserva.
Paso 4: Crea la reserva
La respuesta « /cars/{car_rental_id}/details » devuelve un enlace para completar la sesión de pago y crear una reserva. El punto final /itineraries/car permite completar la reserva.
Paso 5: Consultar la reserva
Para consultar los detalles de la reserva, llama al punto final /itineraries/{itinerary_id}/car para obtener el ID de confirmación establecido en Expedia o a /itineraries/car?affiliate_reference_id={affiliateReferenceId} para obtener el ID que te han asignado.