Visão geral da API Rapid Car
Habilitar reservas robustas de carros alugados end-to-end
O pacote de API /cars
A API Rapid Car permite reservas de aluguel de carros da end-to-end utilizando o impressionante estoque de carros da Expedia Group, criando uma experiência mais completa para os viajantes. Com acesso a 47.000 fornecedores em mais de 190 países, os parceiros podem expandir significativamente suas ofertas e impulsionar as reservas. O design modular da nossa API permite que você personalize o processo de reserva de viajantes com facilidade para atender às necessidades dos seus negócios.
Nossos endpoints oferecem aos desenvolvedores acesso completo aos serviços de aluguel de carros, permitindo funcionalidades como busca de carros disponíveis em todas as localidades, visualização de preços e extras disponíveis, cadastro de formas de pagamento, criação de reservas, recuperação de detalhes da reserva e cancelamentos. Veja abaixo uma visão geral do fluxo de /carros:
Conheça os pontos finais
Como este produto ainda está em fase de acesso antecipado, tenha em mente que os detalhes do esquema e a funcionalidade ainda estão em desenvolvimento ativo e podem sofrer alterações antes do lançamento completo para os parceiros.
| Ação | Método | URI REST | Resultado |
|---|---|---|---|
| Pesquisar carros | GET | /carros/disponibilidade | Retorna os diferentes carros de aluguel disponíveis com base em vários critérios, e.g. pick-up, drop-off, e raio de busca, com um máximo de 200 carros por solicitação. A resposta inclui detalhes como o ID da locadora de veículos, as localizações pick-up/drop-off, o tipo de carro, a quilometragem e muito mais. |
| Observe os detalhes. | GET | /carros/{car_rental_id}/detalhes | Retorna os detalhes de um carro específico, incluindo a discriminação de preços, opcionais e políticas. |
| Cadastre um método de pagamento para a reserva. | POST | /pagamentos | Retorna um token de pagamento que será inserido no corpo da solicitação de criação de reserva. Este endpoint não é o mesmo que em outras APIs. |
| Faça a reserva | POST | /itinerários/carro | Conclui o processo de reserva. |
| Recupere a reserva. | GET | /itinerários/carro | Retorna os detalhes de uma reserva feita por affiliate_reference. |
| GET | /itinerários/{itinerary_id}/carro | Retorna detalhes do itinerário por itinerary_id. | |
| Cancelar uma reserva | EXCLUIR | /itinerários/{itinerary_id}/carro | Cancela uma reserva existente. |
Caso de uso
Veja como você pode usar a API Rapid Car para criar uma experiência de reserva end-to-end.
Passo 1 - Encontre o carro perfeito
Use /cars/availability para permitir que os clientes pesquisem veículos disponíveis para sua localização e datas.
Observação: O número máximo de resultados que serão retornados é 200.
| Parâmetro chave | Descrição | Recomendação |
|---|---|---|
pickup_time | Horário de retirada do carro alugado. | Fornecido no formato ISO 8601 estendido, e.g. 2018-02-12T11:59:00.000Z |
dropoff_time | Horário de devolução do carro alugado. | Fornecido no formato ISO 8601 estendido, e.g. 2018-02-12T11:59:00.000Z |
pickup_area | O local de embarque do veículo é fornecido como um raio e coordenadas. | O formato é radius,latitude,longitude, e.g. 10,37.9838,23.7275. Apenas um dos seguintes elementos, pickup_areaou pickup_airport, é obrigatório. |
dropoff_area | O local de entrega do carro é fornecido como um raio e coordenadas. | O formato é radius,latitude,longitude, e.g. 10,37.9838,23.7275. Apenas um dos seguintes: dropoff_areaou dropoff_airporté permitido. |
pickup_airport | O aeroporto onde o carro será retirado. | Apenas um dos seguintes elementos, pickup_areaou pickup_airport, é obrigatório. |
dropoff_airport | O aeroporto onde o carro será entregue. | Apenas um dos seguintes elementos, dropoff_areaou dropoff_airport, é permitido. |
driver_age | A idade do condutor, se inferior a 30 ou superior a 70 anos. | Deve-se usar o valor padrão de 40, a menos que a idade do motorista esteja indicada como estando fora desses parâmetros. |
currency | A moeda desejada para as taxas. | Dado no formato ISO 4217, e.g. USD. |
language | O idioma desejado para a resposta. | Utilize apenas os códigos de idioma ISO639-1 alfa 2. Consulte esta lista para obter mais informações. |
country_code | O código do país do ponto de venda do viajante. | Fornecido no formato ISO 3166-1 alfa-2. Isso deve representar o país onde a transação está sendo realizada. |
rental_company | Permite filtrar por empresa de aluguel. | É possível especificar no máximo 20 locadoras de veículos, repetindo o parâmetro de consulta rental_company várias vezes. |
Etapa 2 - Obtenha detalhes
Use o endpoint /cars/{car_rental_id}/details para obter informações adicionais sobre o veículo, incluindo um detalhamento de preços e políticas.
Etapa 3 - Obtenha informações do cliente sobre o método de pagamento escolhido.
Agora você pode usar o endpoint /payments para permitir que o cliente registre um método de pagamento para a reserva.
A resposta conterá um payment_token, que deve ser inserido no corpo da solicitação de criação de reserva.
Etapa 4 - Criar a reserva
A resposta /cars/{car_rental_id}/details retorna um link para concluir a sessão de pagamento e criar uma reserva. O endpoint /itineraries/car permite que a reserva seja concluída.
Etapa 5 - Recuperar a reserva
Para recuperar os detalhes da reserva, chame o endpoint /itineraries/{itinerary_id}/car para obter seu ID de confirmação.
Gostou da aparência da nova API do Rapid Cars? Você também pode se interessar pelas nossas próximas APIs de Voos e Atividades. Para obter mais informações, entre em contato com seu gerente de contas.