API de voos gratuita: qual dos três tipos você precisa

Você digitou essas palavras na busca porque tem um fim de semana livre, uma ideia e orçamento zero. Talvez seja um bot de alerta de tarifa, um planejador de viagem para uma comunidade de nicho, ou um site de reservas para a rota que sua família voa todo verão. Os resultados parecem generosos: um fornecedor atrás do outro com plano gratuito, formulário de cadastro e uma chave na caixa de entrada em minutos. Aí, alguns dias depois de começar, você descobre que o que integrou não consegue fazer a única coisa que o seu produto prometia.
Isso acontece porque uma API de voos gratuita não é uma categoria só. A expressão traz três tipos de produto diferentes, e só um deles deixa você vender uma passagem. Saber qual deles está na sua frente antes de escrever a primeira requisição é o que salva a semana.
Três coisas respondem por "API de voos gratuita"
Tire o marketing e quase todo resultado cai em uma destas:
| Tipo | O que uma chamada retorna | Acesso gratuito, em geral | Dá para vender passagem com ela? | Quem fica com o dinheiro |
|---|---|---|---|---|
| Dados de status e horários de voo | Partidas, chegadas, atrasos, portões, horários, às vezes posições passadas | Comum: plano gratuito com limite ou chave de teste | Não. A resposta não tem tarifa nem assento | Ninguém. É informação |
| Busca com redirecionamento (afiliado) | Preços de um índice de metabusca e um deep link para o checkout de outra empresa | Comum: cadastro grátis, remuneração por comissão quando o clique vira reserva | Não. O viajante reserva e paga no site do parceiro | O site parceiro; você ganha comissão se o clique converter |
| Inventário reservável | Ofertas ao vivo que você pode buscar, precificar, segurar, reservar e emitir como bilhete eletrônico | Raramente mais que um sandbox; produção vem com contrato | Sim. É exatamente para isso | Quem emite o bilhete, sob o próprio credenciamento |
A última coluna é a diferença de verdade. Os dois primeiros tipos podem ser gratuitos porque o dinheiro de ninguém está em risco quando você os chama. O terceiro não pode, e o motivo não tem nada a ver com a generosidade do fornecedor.
Dados de status são úteis, mas não são produto de reserva
Uma API de dados de voo responde perguntas sobre voos que existem: o voo noturno de Guarulhos para Dubai sai no horário, de qual portão, como fica a grade dessa rota no mês que vem. É a ferramenta certa para um alerta de atraso, uma tela de aeroporto, um painel de viagens corporativas ou um produto de pedido de indenização. É a ferramenta errada para qualquer coisa com preço. Às vezes o desenvolvedor monta uma página de busca convincente em cima de dados de horário, coloca um botão "reservar" e só então pergunta de onde vem a tarifa. Não vem dali.
Busca de afiliado é um negócio, só que não um que você controla
O tipo com redirecionamento fica mais perto do que a maioria imagina. Você envia origem, destino e datas; recebe preços e um link. Quando o viajante clica, ele sai do seu site, reserva no checkout do parceiro e, se a reserva for concluída, você ganha uma comissão algumas semanas depois.
Isso pode ser um negócio real, e muito site de conteúdo vive disso. Só tenha clareza sobre o que você está abrindo mão. O preço exibido geralmente vem de um índice em cache, então pode ser diferente do que o viajante vê depois do clique. Nome, e-mail e localizador do cliente pertencem ao parceiro, não a você. Você não consegue colocar markup, juntar um hotel, oferecer sua própria forma de pagamento nem atender o telefone quando o voo é cancelado, porque do seu lado não há nada para mudar. Você está mandando tráfego, e o tráfego é o produto.
Se o que você quer é uma marca que vende viagem, com clientes e margem próprios, esse tipo vai parecer ótimo por um mês e depois virar o teto.
Por que inventário reservável nunca é grátis na hora da passagem
Buscar e precificar são operações de leitura. Emitir passagem é um ato financeiro. Alguém precisa ter uma placa de emissão IATA (ou um acordo direto com a companhia aérea), emitir o bilhete eletrônico sob ela e liquidar o dinheiro pelo BSP ou pelo canal da própria companhia. Quem quer que seja passa a dever o bilhete à companhia, com ou sem o pagamento do seu cliente se confirmar.
É ali que a fraude cai. Uma reserva paga com cartão roubado é uma passagem que o emissor já pagou, e um chargeback semanas depois toma o dinheiro de volta de quem aceitou o pagamento. Regras tarifárias quebradas por automação descuidada voltam como ADM (agency debit memo) endereçadas ao dono da placa. Por isso o dono da placa quer saber quem está enviando reservas, de onde e com quais controles, antes que o seu código tenha permissão de apertar o botão. Essa análise é o contrato, e é por causa dela que o "grátis" para no sandbox.
Nada disso significa que uma API reservável esteja fora do alcance de um time pequeno. Significa que o custo aparece em algum lugar: uma taxa por reserva, uma margem embutida na tarifa net que você recebe, um depósito ou um limite de crédito dentro do qual você trabalha. Pergunte qual, e cedo. Um fornecedor que não sabe explicar como o dinheiro se move depois da emissão também ainda não terminou de pensar nisso.
O que um sandbox deve deixar você fazer antes de qualquer contrato
Um bom sandbox é a parte gratuita de uma API reservável, e deve bastar para mostrar se a integração vale uma conversa comercial. Antes de assinar qualquer coisa, confira se você consegue:
- Buscar rotas reais. Não uma resposta pronta. Teste uma rota curta cheia de low cost e uma de longa distância, e veja se o conteúdo muda do jeito que você esperaria.
- Precificar e precificar de novo. Pegue uma oferta da busca, precifique, espere, precifique outra vez. Descubra quanto tempo uma oferta continua válida e como fica a resposta quando o preço mudou.
- Segurar sem emitir. Crie uma reserva que bloqueia assentos mas não emite, leia o prazo dela e depois cancele. Se o sandbox só permite buscar, você está avaliando a metade fácil.
- Quebrar coisas de propósito. Envie um nome com caracteres que a companhia vai recusar, um bebê sem adulto, uma data no passado. Erros legíveis valem mais que qualquer lista de recursos.
- Ver as chamadas pós-reserva. Cancelamento, void e reembolso ou existem na API ou passam por uma central de suporte. Você quer saber qual antes que o seu primeiro cliente real pergunte.
Algumas coisas um sandbox nunca vai mostrar: estoque real acabando, mudança de malha da companhia, liquidação. Escrevemos um plano de testes em sandbox mais completo sobre o que simular e o que nunca simular, e um passo a passo do fluxo inteiro de reserva para quando você passar dessa fase.
Onde esta plataforma fica
Sem rodeios: esta plataforma oferece APIs de voos e hotéis, e elas são do tipo reservável. O acesso começa com uma conversa, não com uma chave self-service. Se você precisa de uma chave hoje à noite para terminar um hackathon, não somos nós, e é melhor saber disso por este parágrafo do que por um formulário de cadastro.
A conversa passa pelas perguntas acima: o que você está construindo, se precisa de emissão ou só de busca e preço, em quais mercados vende, como as reservas serão pagas. Essas respostas definem que conteúdo você vê e como funciona a liquidação. Se você está nesse ponto, a página de APIs de viagem é onde começa.
Quanto custa escolher o tipo errado
O erro caro não é pagar por uma API. É construir o produto sobre o tipo errado e descobrir na frente de alguém importante.
Funciona assim. A demo roda num feed de afiliado ou em dados de horário porque era grátis e rápido. A página de busca parece pronta. Um investidor, uma agência parceira ou o seu primeiro cliente de verdade pede para reservar, e a única resposta honesta é que o botão leva para fora do site, ou não faz nada. Aí começa a reconstrução, e ela é maior que trocar de fornecedor: resultado de afiliado não traz id de oferta para precificar, não tem bloqueio, não tem modelo de passageiro, então o código por trás da página de busca precisa mudar junto com a API que ele chama.
Times que migraram de um fornecedor reservável para outro conhecem uma versão mais branda da mesma lição; falamos disso em substituir uma API de voos self-service. O caminho mais barato é decidir primeiro a última coluna da tabela. Se o seu produto precisa cobrar por uma passagem, comece a conversa do reservável na primeira semana e monte a demo no sandbox dele, mesmo que as opções gratuitas entregassem uma tela mais bonita antes.