Web API Aéreo - Documentação Oficial Wooba
A Web API Aéreo é a interface REST oficial e moderna da Wooba para busca, tarifação, reserva, emissão de bilhetes e gestão pós-venda de passagens aéreas junto a dezenas de companhias aéreas, GDSs (Sabre, Amadeus) e conexões NDC em tempo real.
:::tip PADRÃO OFICIAL DE INTEGRAÇÃO Esta é a documentação recomendada para todos os clientes, agências, operadoras e integradores de tecnologia. Novos projetos devem ser desenvolvidos exclusivamente utilizando esta API. :::
1. Ambientes e URLs Base
A API é disponibilizada em dois ambientes:
| Ambiente | URL Base | Finalidade |
|---|---|---|
| Sandbox (Homologação) | https://wooba-sandbox-api.travellink.com.br | Ambiente para testes, validações e certificação de fluxo |
| Produção | Informada no credenciamento pelo Consolidador/Operadora | Ambiente real conectado às companhias aéreas |
2. Padrões de Rota e Versões
A API disponibiliza rotas desenhadas para atender diferentes perfis de integração:
2.1 Rota Principal em Português (/api/V2/Voos) - Recomendada
Padrão oficial para sistemas nacionais e OTAs brasileiras, com nomenclatura de campos e parâmetros em português (Origem, Destino, DataIda, QuantidadeAdultos, etc.).
- Exemplo:
POST https://wooba-sandbox-api.travellink.com.br/api/V2/Voos/Disponibilidade
2.2 Rota Internacional em Inglês (/api/V2/Flights)
Espelho completo da API projetado para plataformas globais e ferramentas internacionais de reserva (OBTs), com rotas e propriedades JSON integralmente em inglês (Origin, Destination, DepartureDate, Adults, etc.).
- Exemplo:
POST https://wooba-sandbox-api.travellink.com.br/api/V2/Flights/Availability
2.3 Rota de Alta Performance V3 (/api/V3/Voos)
Endpoint otimizado especificamente para a pesquisa de disponibilidade com resposta enxuta, alta agregação de voos e menor consumo de banda.
- Exemplo:
POST https://wooba-sandbox-api.travellink.com.br/api/V3/Voos/Disponibilidade
3. Características Técnicas
- Protocolo: HTTPS obrigatório.
- Formato dos Dados: JSON (
Content-Type: application/json; charset=utf-8). - Autenticação: Baseada em cabeçalhos de segurança de desenvolvedor (
developer-tokenedeveloper-access-code) e credenciais de agência no corpo das requisições. - Formato de Datas: Padrão universal ISO 8601 (
YYYY-MM-DDTHH:mm:ss). - Arquitetura Stateless: Cada chamada é independente, garantindo alta escalabilidade e tolerância a falhas.