Visão geral da API Rapid Car
Habilitar reservas robustas de carros alugados end-to-end
O pacote Car API
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.
Interações do viajante com a API do carro
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 | /cars/availability | 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 | /cars/{car_rental_id}/details | 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 | /payments | 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 | /itineraries/car | Conclui o processo de reserva. |
| Recupere a reserva. | GET | /itineraries/car | Retorna os detalhes de uma reserva feita por affiliate_reference. |
| Recuperar o itinerário | GET | /itineraries/{itinerary_id}/car | Retorna detalhes do itinerário por itinerary_id. |
| Cancelar uma reserva | DELETE | /itineraries/{itinerary_id}/car | Cancela uma reserva existente. |
Como funciona
Veja como você pode usar a API Rapid Car para criar uma experiência de reserva end-to-end.
Passo 1: Procure 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. 2027-02-12T11:59:00 |
dropoff_time | Horário de devolução do carro alugado. | Fornecido no formato ISO 8601 estendido, e.g. 2027-02-12T11:59:00 |
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_area ou 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_area ou dropoff_airport é permitido. |
pickup_airport | O aeroporto onde o carro será retirado. | Apenas um dos seguintes elementos, pickup_area ou pickup_airport, é obrigatório. |
dropoff_airport | O aeroporto onde o carro será entregue. | Apenas um dos seguintes elementos, dropoff_area ou dropoff_airport, é permitido. |
driver_age | A idade do condutor, se inferior a 30 ou superior a 70 anos. | Sugerimos um valor padrão de 40 quando a idade do condutor não for inferior a 30 nem superior a 70 anos, a menos que a sua jurisdição tenha um requisito específico. |
currency | A moeda desejada para as taxas. | Dado no formato ISO 4217, e.g. USD. |
language | O idioma desejado para a resposta. | O formato de idioma deve usar um código de idioma ISO639-1 de 2 letras mais o código de localidade BCP-47 de 2 letras. >> Veja todos os idiomas suportados pelo Rapid |
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. |
traffic_profile | A versão do seu site (por exemplo, web ou aplicativo) usada para a pesquisa. | Ajudaremos você a configurar esse valor de string quando você configurar seu site. |
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.
Passo 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 o ID de confirmação definido pela Expedia ou /itineraries/car?affiliate_reference_id={affiliateReferenceId} para obter o ID atribuído por você.