Cómo obtener detalles del vehículo de alquiler y complementos de equipo
Después de que un usuario seleccione un vehículo de los resultados de la búsqueda, llame al punto final de Detalles del alquiler para recuperar información ampliada. Esto incluye complementos de equipo disponibles (asientos para niños, unidades de GPS, etc.), horarios de atención del lugar de recogida, términos específicos del proveedor y reglas de tarifas detalladas.
Punto final
GET /cars/api/v2/rental/details
Parámetros de solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
country | cadena | Sí | Código de país ISO de dos letras (por ejemplo, US). |
currency | cadena | Sí | Código de moneda de tres letras (por ejemplo, USD). |
availability_token | cadena | Sí | El valor token de un resultado de búsqueda en la respuesta de búsqueda de alquileres. |
Solicitud de ejemplo
HTTP
GET /cars/api/v2/rental/details?country=US¤cy=USD&availability_token=eyJhbGciOiJIUzI1NiIsInR5cCI6...
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Ejemplo de respuesta
JSON
{
"data": {
"vehicle": {
"air_conditioning": true,
"transmission_type": "Automatic",
"fuel_type": "Petrol",
"drive_type": "2WD",
"passenger_quantity": 5,
"baggage_quantity": 2,
"vehicle_size": "Standard",
"vehicle_type": "Sedan",
"sipp_code": "CCAR",
"name": "Toyota Camry or similar",
"door_count": 4,
"picture_url": "https://images.example.com/camry.png"
},
"rental_rate": {
"rate_distance": "Unlimited",
"vehicle_charges": [
{
"currency_code": "USD",
"base_price": 245,
"total_price": 289.75,
"tax_inclusive": true,
"purpose": "rental"
}
],
"rate_restrictions": {
"minimum_age": 21,
"maximum_age": 75
}
},
"equipments": [
{
"code": "CSI",
"name": "Infant Child Seat",
"description": "Rear-facing child seat for infants up to 12 months.",
"charge": {
"currency_code": "USD",
"amount": 12,
"unit": "per_day"
},
"max_quantity": 2
},
{
"code": "CST",
"name": "Toddler Child Seat",
"description": "Forward-facing child seat for toddlers aged 1-4 years.",
"charge": {
"currency_code": "USD",
"amount": 12,
"unit": "per_day"
},
"max_quantity": 2
},
{
"code": "NAV",
"name": "GPS Navigation",
"description": "Portable GPS navigation unit.",
"charge": {
"currency_code": "USD",
"amount": 15,
"unit": "per_day"
},
"max_quantity": 1
}
],
"location_details": {
"pickup": {
"name": "Hertz - Manhattan Midtown",
"address": {
"street": "310 W 40th St",
"city": "New York",
"state": "NY",
"postal_code": "10018",
"country": "US"
},
"operating_hours": [
{
"day": "Monday",
"open": "07:00",
"close": "21:00"
},
{
"day": "Tuesday",
"open": "07:00",
"close": "21:00"
},
{
"day": "Wednesday",
"open": "07:00",
"close": "21:00"
},
{
"day": "Thursday",
"open": "07:00",
"close": "21:00"
},
{
"day": "Friday",
"open": "07:00",
"close": "21:00"
},
{
"day": "Saturday",
"open": "08:00",
"close": "18:00"
},
{
"day": "Sunday",
"open": "09:00",
"close": "17:00"
}
],
"pickup_instructions": "Counter is located on the ground floor. Please present your booking confirmation and a valid driver's license."
},
"dropoff": {
"name": "Hertz - Manhattan Midtown",
"address": {
"street": "310 W 40th St",
"city": "New York",
"state": "NY",
"postal_code": "10018",
"country": "US"
}
}
},
"rate_rules": {
"fuel_policy": "Full to full",
"mileage_policy": "Unlimited mileage included",
"cancellation_policy": "Free cancellation up to 48 hours before pickup.",
"noshowfee": {
"currency_code": "USD",
"amount": 50
}
},
"vendor_messages": [
"A credit card in the main driver's name is required at pickup.",
"A security deposit of $200 will be held on the credit card.",
"Additional drivers must present a valid driver's license at pickup."
]
}
}Complementos de equipo
La matriz equipments enumera elementos opcionales que el cliente puede agregar a su alquiler. Cada artículo incluye:
| Campo | Tipo | Descripción |
|---|---|---|
code | cadena | Código de equipo único (por ejemplo, CSI, NAV). |
name | cadena | Nombre legible por humanos del complemento. |
description | cadena | Descripción detallada del equipo. |
charge | objeto | Detalles de precios que incluyen currencycode, amount y unit. |
maxquantity | número | Número máximo de este elemento que se puede agregar. |
Los códigos de equipos comunes incluyen:
| Código | Equipos |
|---|---|
CSI | Asiento infantil infantil |
CST | Asiento infantil para niños pequeños |
CSB | Asiento elevador para niños |
NAV | Navegación GPS |
SKI | Portaesquís |
SWC | Cadenas para la nieve |
Al crear una reserva, pase los códigos y las cantidades del equipo seleccionado en el cuerpo de la solicitud.
Detalles de ubicación
El objeto location_details proporciona información completa sobre la dirección y el horario de atención de las ubicaciones de recogida y entrega.
Campos clave para mostrar al usuario:
address— Dirección postal completa para mapas e indicaciones.operating_hours— Horarios de apertura y cierre diarios. Si la hora de recogida o regreso seleccionada cae fuera del horario de atención, es posible que la reserva no sea posible.pickup_instructions: instrucciones específicas del proveedor para recoger el vehículo.
Reglas de tarifas
El objeto rate_rules contiene términos importantes:
| Campo | Descripción |
|---|---|
fuelpolicy | La política de devolución de combustible (por ejemplo, "Lleno a lleno", "Combustible prepago"). |
mileagepolicy | Si el kilometraje es ilimitado o está limitado. |
cancellationpolicy | Ventana de cancelación gratuita y cualquier tarifa que se aplique después. |
noshow_fee | Tasa cobrada si el cliente no recoge el vehículo. |
Mensajes de proveedores
La matriz vendor_messages contiene avisos importantes de la empresa de alquiler. Estos pueden incluir requisitos para tarjetas de crédito, depósitos o documentación. Muéstrelos siempre al cliente antes de que confirme una reserva.
Consejos
- Llame a este punto final antes de mostrar el formulario de reserva. La lista de equipos y los requisitos del proveedor son esenciales para que el cliente tome una decisión informada.
- Validar la hora de recogida con el horario de atención. Alertar al usuario si la hora seleccionada queda fuera del horario de atención de la ubicación.
- Muestre la política de cancelación de manera destacada. Los clientes deben conocer la ventana de cancelación gratuita antes de comprometerse con una reserva.