Pular para o conteúdo
Blog

Melhor API de reserva de voos: diga primeiro o que está construindo

Redação Tekravel
Escrito com a ajuda de IA

A tarefa diz: encontre a melhor API de reserva de voos. Você abre três páginas de comparação, e elas classificam o mesmo punhado de nomes em três ordens diferentes, cada uma com sua grade de recursos marcados. Na terceira página você percebe o que nenhuma perguntou: o que acontece com o cliente depois que os resultados da busca voltam.

Essa pergunta ausente é a resposta inteira. A melhor API de reserva de voos para uma página que manda o visitante ao site da companhia aérea é uma escolha ruim para um site que fica com a reserva e com o cartão. E nenhuma das duas serve para a ferramenta interna que a equipe de uma agência vai usar o dia todo. Busca, preço e reserva parecem iguais em qualquer documentação. O que muda fica por baixo, e qual dessas diferenças vai doer depende inteiramente do produto.

Três produtos que todos chamam de "site de reserva de voos"

O primeiro é uma página de comparação ou de inspiração: mostra tarifas, manda o link adiante, nunca toca no bilhete. Aqui a API é quase só busca. Importa a amplitude e o frescor dos resultados, e que o preço exibido fique perto do que o visitante verá ao chegar. Nada no seu sistema precisará anular, reembolsar ou reemitir, então a força de um fornecedor nisso é desperdiçada com você.

O segundo vende. O visitante paga a você, você reserva, e a partir desse momento o ciclo de vida da reserva é seu: confirmar o preço antes de cobrar, lidar com uma companhia que responde devagar, anular no mesmo dia, reembolsar depois, reemitir quando o cliente muda a data. Para esse produto, o endpoint de busca é a parte fácil. O que decide a escolha vem depois dele.

O terceiro é a ferramenta da própria agência, usada por uma equipe que já tem relação com fornecedores. Busca crua não é o ponto. O que importa é que o conteúdo negociado da agência apareça, que subagentes respeitem limites de crédito, que os markups sejam aplicados antes que alguém veja um preço e que existam relatórios no fim do mês. Uma API excelente no segundo produto pode ser a base errada aqui.

Vale dizer sem rodeios: a mesma API não pode ser a melhor nos três. Se um ranking afirma que é, ele não conheceu o segundo.

As propriedades que vale comparar, e quem depende delas

Reduza a grade de recursos às linhas sobre as quais um desenvolvedor poderia de fato discordar. Cada produto se apoia num subconjunto diferente; o resto você pode ignorar tranquilamente.

PropriedadePágina de redirecionamentoVende e recebe pagamentoFerramenta da equipe da agência
Quão desatualizado um preço exibido pode estar antes de ser confirmadoImporta um poucoDecisivo: você cobra com base neleImporta, a equipe cota com ele
O que uma reserva devolve quando a companhia aérea demoraNão se aplicaDecisivoImporta
Quem pode anular e reembolsar, e como isso é pedidoNão se aplicaDecisivoDecisivo
Como se resolve uma reserva de resultado desconhecidoNão se aplicaDecisivo: o cartão pode já ter sido cobradoImporta
Se o conteúdo e as regras de crédito da agência se aplicamNão se aplicaÀs vezesDecisivo
Quanto o comportamento de teste difere do realBaixoAltoAlto

Leia a sua coluna e ignore as outras. O erro que custa dinheiro é ler a coluna do redirecionamento, porque é a mais fácil de avaliar, e construir o segundo produto.

O preço que você mostra ainda não é o preço que você cobra

Pegue o segundo produto e siga uma tarifa por ele. A busca devolve um preço. O visitante olha, pensa, abre outra aba e volta. Algum tempo depois aperta o botão. Entre a busca e o botão a tarifa ficou parada no seu sistema, e a única pergunta honesta sobre qualquer API é o que ela vai dizer quando você perguntar de novo nesse momento.

Um fornecedor pode dar três respostas. Pode confirmar o preço que você mostrou. Pode devolver um preço novo, e seu código precisa decidir se cobra a diferença, pergunta ao cliente ou para. Ou pode dizer que a tarifa acabou. Um site que só se preparou para a primeira resposta funciona em toda demonstração e falha nas semanas seguintes, e falha de um jeito que custa dinheiro em vez de gerar erros.

Portanto a questão de design não é se a API tem uma etapa de confirmação de preço. Quase todas têm. É como a resposta se parece nos três desfechos, e se o seu código consegue distingui-los sem adivinhar. Peça um exemplo de cada. Um fornecedor que mostra o segundo e o terceiro na documentação pensou no seu produto. Um que mostra só o primeiro pensou na demonstração.

Um teste de uma tarde que nenhuma grade oferece

Seja qual for a lista curta, faça o mesmo teste rápido com cada nome, provocando as falhas de propósito. Reserve algo e veja o que o objeto da reserva guarda depois de emitido. Verifique o preço do mesmo itinerário duas vezes, com minutos de intervalo, e compare a segunda resposta com a primeira. Cancele, depois peça um reembolso, e anote quem precisa agir. Então faça ao fornecedor, por escrito, duas perguntas: o que o seu sistema devolve quando a companhia aérea dá timeout no meio da reserva, e como eu descubro o que de fato aconteceu.

As respostas por escrito valem mais que a demonstração. Um fornecedor com um procedimento claro para o resultado desconhecido já enfrentou o problema. Um que responde com o nome de um recurso, não.

Para montar o próprio plano de testes, o plano de sandbox mostra o que o sandbox não vai revelar. E se você está pesando fornecedores pelo que existe por trás da API, e não pela API em si, essa é outra questão, com artigo próprio; este fica no produto.

O preço de escolher pela lista de endpoints

As falhas são silenciosas. Um site confirma preços tarde, e a diferença entre a tarifa exibida e a real sai da sua margem, uma reserva por vez. Uma reserva fica em estado desconhecido com o cartão do cliente já cobrado, e alguém precisa resolver à mão, geralmente por e-mail, geralmente num fim de semana. Uma ferramenta construída sobre conteúdo que só serve para busca acaba sendo algo do qual a equipe não consegue emitir, e o projeto é refeito em torno de outro conteúdo.

Nada disso aparece numa grade de marcações. Tudo estava visível na primeira coluna da tabela acima, antes de uma linha de código.

A nossa posição é mais estreita do que um ranking nos deixaria afirmar. A Tekravel expõe APIs de voos e hotéis, o acesso começa por uma conversa e não por uma chave de autoatendimento, os serviços são ativados por tenant e o conteúdo dos fornecedores chega a cada tenant por meio de grupos de fornecedores. Isso serve ao segundo e ao terceiro produto. Se você está construindo o primeiro, talvez nem precise de nós. Se está construindo um dos outros, a página das APIs é o lugar para começar a conversa.

Redação Tekravel

Mesa de tecnologia de viagens

A mesa de tecnologia de viagens da Tekravel escreve para o setor: donos de agências, consolidadores e os programadores que os integram. Cada artigo é verificado na plataforma que descreve antes de ser publicado.