Visão geral da API de Atividades Rápidas
Capacite seus clientes a reservar atividades autênticas com a API Rapid Activities.
Prévia de acesso antecipado
Esta documentação faz parte de uma iniciativa de acesso antecipado exclusiva para parceiros selecionados. Os programas piloto serão lançados até o quarto trimestre de 2025, com disponibilidade geral em 2026.
Se você tiver interesse em se tornar um parceiro piloto ou beta, entre em contato com seu gerente de contas.
A API Rapid Activities foi projetada para ajudar você a apresentar atividades e experiências aos viajantes por meio de um processo de reserva fácil de integrar. Isso proporciona aos viajantes uma experiência de reserva mais completa, ao mesmo tempo que permite que você explore novas fontes de receita.
Como criar o fluxo de reservas de atividades
Os passos descritos abaixo fornecem uma visão geral da integração com a API de Atividades e da criação do seu fluxo de reservas. A API de Atividades Rápidas é composta por uma seleção de endpoints que, juntos, possibilitam um fluxo search-to-book.
Nota: 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 mudar antes do lançamento completo deste produto para os parceiros.
1. Pesquisar atividades disponíveis
O endpoint availability recupera atividades e experiências disponíveis com base em um local e intervalo de datas específicos.
Confira os principais parâmetros abaixo:
| Parâmetro chave | Descrição | Recomendação |
|---|---|---|
start_date | A data de início para a busca de atividades disponíveis. | Utilize o formato ISO 8601. Por exemplo, 2018-02-12. |
end_date | Data limite para a busca de atividades disponíveis. | Utilize o formato ISO 8601. Por exemplo, 2018-02-12. |
currency | Moeda solicitada para as taxas. | Utilize o formato ISO 4217. Por exemplo, USD. |
language | Idioma desejado para a resposta. | Use apenas códigos de idioma Alpha-2 ISO639-1 e de país Alpha-2 ISO3166-1. |
country_code | O código do país do ponto de venda do viajante. | Utilize o formato ISO 3166-1 alfa-2. Deve representar o país onde a transação de compra está ocorrendo. Por exemplo, os EUA. |
region_id | O local ou área onde o viajante procura atividades. | Por exemplo, 1122931. |
limit | O número máximo de atividades retornadas na resposta. | Máximo: 100 |
2. Veja as ofertas para a atividade escolhida.
O endpoint offers fornece ao viajante mais detalhes sobre as ofertas disponíveis para a atividade escolhida, incluindo horários, preços e disponibilidade da excursão.
Aqui estão os detalhes que os viajantes precisam saber antes de reservar:
| Ponto de extremidade | Use-o para... |
|---|---|
callouts | Forneça aos clientes informações importantes sobre a atividade antes de reservá-la. |
inclusions | Descreva brevemente todas as funcionalidades incluídas na atividade. |
exclusions | Forneça uma lista de recursos não incluídos na atividade. |
3. Verifique o preço e forneça os detalhes de pagamento.
Depois que o viajante encontrar a experiência de férias perfeita, use o endpoint offer_id para verificar os preços e as informações de reserva necessárias.
4. Obtenha informações do viajante 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.
5. Crie a reserva
Use o endpoint activity para criar uma reserva. Este endpoint retornará um itinerary_id com todos os links de operação relevantes.
6. Recuperar detalhes da reserva
Você pode usar o endpoint activity para recuperar detalhes da reserva usando o ID do itinerário. A resposta incluirá links para cancelamento, quando aplicável.
Detalhes da API
Explore as configurações do endpoint activity-related nesta página e, em seguida, use um software de teste para entender como os exemplos e as configurações de esquema se comparam à saída real. Quando esta API passar da fase piloto, seus endpoints também serão incluídos em nosso API Explorer.