Visão geral da API de Atividades Rápidas
Capacite os viajantes a reservar atividades e experiências 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 no segundo trimestre de 2026, com disponibilidade geral em 2027.
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 aos viajantes por meio de um fluxo de compra e reserva fácil de integrar. Isso proporciona aos viajantes uma experiência mais completa, ao mesmo tempo que permite desbloquear novas fontes de receita.
Conceitos-chave
- Produto: Uma atividade que pode ser reservada (aquilo que você mostra e vende).
- Grupo de produtos: Um pacote de produtos similares.
- Experiência: Um invólucro conceitual/de marketing que pode conter vários produtos.
- Ingressos: Tipos de ingressos para um produto (adulto/criança/bebê, etc.).
- Itinerário: Uma reserva (reserva de atividade) com um produto.
Fluxo de integração de ponta a ponta
O agendamento de atividades com esta API segue este fluxo geral.
Etapa 1: Descubra o estoque
Entenda o que você pode vender em um destino e crie um catálogo estruturado de atividades por destino, pronto para ser comercializado.
- Mapear regiões para o estoque subjacente (experiências, grupos de produtos e produtos).
- Obtenha conteúdo detalhado das atividades (títulos, descrições, imagens, locais e etiquetas) em vários idiomas.
- Use isso para preencher resultados de pesquisa, páginas de detalhes de atividades e filtros (e.g., 'ideal para famílias' ou 'passeios a pé').
Passo 2: Verifique a disponibilidade e os preços.
Saiba quando as atividades estão disponíveis e a que preço. Utilize datas/horários reserváveis, opções de ingressos e faixas de preço para otimizar a experiência de compra.
- Para produtos e datas específicas, solicite disponibilidade e preços por tipo de ingresso.
- Exibir calendários (datas disponíveis/indisponíveis), horários disponíveis e preços na experiência do comprador.
from - Suporte a múltiplos produtos e moedas em uma única chamada.
Etapa 3: Verificação de preço do Pre-booking
Confirme o preço final da reserva e os requisitos necessários antes de efetuar o pagamento. Receba uma oferta confirmada e um código de reserva, de acordo com o estoque e as políticas mais recentes.
- Revalidar uma seleção específica (produto, data, hora e ingressos) em tempo real.
- Receba o preço final, impostos/taxas e disponibilidade (incluindo alterações de preço ou esgotamento do estoque).
- Obtenha uma lista dos campos de reserva obrigatórios (e.g., detalhes do passageiro, tipo pick-up) e um token seguro para a reserva.
Passo 4: Criar reserva
Transforme uma seleção confirmada em uma reserva. Receba um itinerário confirmado (reserva) que você poderá visualizar e gerenciar em seus próprios sistemas.
- Envie o token de reserva, o token de pagamento e os dados do viajante (viajante principal e viajantes adicionais).
- Inclua sua própria referência de afiliado para que você possa conciliar e pesquisar reservas posteriormente.
- Receba um ID de itinerário e links para recuperar os detalhes da reserva.
Etapa 5: Gerenciar reservas
Apoiar os fluxos de trabalho pós-reserva para clientes e agentes. Acesse um conjunto completo de ferramentas pós-reserva para visualizar, cancelar e fornecer vouchers para reservas existentes.
- Recupere os detalhes da reserva pelo ID do itinerário ou pela sua referência de afiliado.
- Cancelar reservas quando permitido e informar o cliente sobre a situação resultante.
- Recupere os comprovantes de compra para que os clientes os apresentem na atividade.
Resumo dos endpoints por caso de uso
| Caso de uso | Método e caminho | Notas/parâmetros principais |
|---|---|---|
| Region-to-inventory mapeamento | GET /activities/regions/{region_id} | include[]=experience_ids/product_group_ids/product_ids |
| Conteúdo da experiência | GET /activities/experiences/content | experience_id[], language, filtros de tag opcionais |
| Conteúdo do grupo de produtos | GET /activities/product_groups/content | product_group_id[], language, filtros de tag opcionais |
| Conteúdo do produto | GET /activities/products/content | product_id[], language |
| Horário de funcionamento do produto | GET /activities/products/{product_id}/open_times | start_date, end_date (≤ 90 dias),language |
| Tags | GET /activities/references/tags | pagination_size, language |
| Tipos de etiqueta | GET /activities/references/tag_types | language |
| Avaliações dos hóspedes | GET /activities/products/{product_id}/guest-reviews | language, pagination_size |
| Disponibilidade e preço | GET /activities/availability | product_id[], start_date, end_date (≤14), currency, language |
| Disponibilidade no calendário | GET /activities/calendars/availability | product_id[], start_date,end_date |
| Verificação de preço | GET /activities/products/{product_id}/price-check | token, tickets |
| Criar reserva | POST /itineraries/activity | Token de consulta; corpo CreateItineraryRequest |
| Recuperar por ID do itinerário | GET /itineraries/{itinerary_id}/activity | Informações completas e links para cancelamento/voucher |
| Recuperar por referência de afiliado | GET /itineraries/activity | Consulta affiliate_reference_id |
| Cancelar reserva | DELETE /itineraries/{itinerary_id}/activity | • 204 = cancelado • 202 = estado desconhecido |
| Recuperar voucher | GET /itineraries/{itinerary_id}/activity/voucher | Link para o cupom de devolução |
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.