Pular para o conteúdo
Blog

Comparação de APIs de viagem: avalie eixos, não fornecedores

Redação Tekravel
Escrito com a ajuda de IA

Você está com três apresentações de fornecedores abertas em três abas. Cada uma tem um slide com uma longa lista de companhias aéreas, um slide com a quantidade de hotéis, um sandbox, REST e JSON, e um e-mail de suporte. Você monta uma planilha, marca um tique em cada célula, e a planilha termina empatada. É assim que costuma acabar uma comparação de APIs de viagem feita como checklist de funcionalidades — e é o final errado, porque as diferenças que vão decidir o seu próximo ano só aparecem depois do go-live: na reserva que deu certo no fornecedor mas estourou o timeout do seu lado, no reembolso que ninguém consegue processar, na companhia que estava na lista mas não pode ser emitida por essa rota.

Este texto é para o desenvolvedor ou líder técnico que precisa tomar essa decisão e defendê-la depois. Ele não ranqueia fornecedores. Ele entrega eixos de comparação, um plano de trial que gasta o tempo com falhas e um conjunto curto de perguntas que mostram rapidamente se você está falando com um fornecedor ou com o revendedor do fornecedor de outra empresa.

Por que o checklist de funcionalidades sempre termina empatado

Um checklist pergunta se uma capacidade existe. Quase toda API de viagem consegue dizer sim a quase toda linha, porque as linhas são escritas no nível da página de marketing: busca, preço, reserva, cancelamento, emissão, webhooks, sandbox. A pergunta que separa uma da outra não é se cancel existe, e sim o que acontece quando você o chama numa reserva já emitida, doze horas antes do embarque, numa tarifa com multa, por uma rota em que o conteúdo veio de terceiros. Um checklist não tem coluna para isso.

Existe um segundo problema. Quem preenche o checklist, em geral, é o próprio fornecedor. Você está dando nota à autodescrição dele.

Uma comparação de APIs de viagem montada em eixos, não em fornecedores

Troque a grade fornecedor-por-funcionalidade por eixos que você mesmo pontua, com evidências coletadas no trial. A tabela abaixo é a que nós usaríamos. Você pode dar pesos diferentes às linhas — uma operação só de hotéis se importa menos com emissão — e vale discutir com ela antes de adotá-la.

EixoO que um checklist perguntaO que descobrir de verdadeComo soa uma resposta fraca
CoberturaQuantas companhias e hotéis?Quantos podem ser buscados, reservados E emitidos ou confirmados por esta API, nos seus mercadosUm número grande, sem divisão
ProfundidadeExiste endpoint de cancelamento?Quais ações pós-reserva são automatizadas por fonte de conteúdo: void, reembolso, reemissão, correção de nome, serviços adicionais“Nossa equipe de operações cuida disso”
Integridade de preçoO preço é em tempo real?Com que frequência o preço na reserva difere do preço na busca, e como a API avisa você“Os preços são sempre ao vivo”
Semântica de errosOs erros estão documentados?Se um erro diz em que estado está a reserva, e não só que algo falhouUm código genérico para toda falha
Idempotência—Se uma chamada de reserva repetida pode criar uma segunda reservaSilêncio, depois “nunca vimos isso”
Fornecedor contratual—De quem é o contrato, o código IATA e o BSP pelo qual o bilhete passa“Trabalhamos com todos os grandes GDS”
Acesso e suporteTem sandbox?Quem responde quando um PNR real trava, e em quanto tempoUm formulário de chamado e nenhum contato nominal

Duas dessas linhas não têm pergunta nenhuma no checklist. Não é por acaso: são as linhas que mais custam quando dão errado, e as que uma apresentação comercial tem menos chance de mencionar por conta própria.

Cobertura não é profundidade

A lista de companhias aéreas é o slide mais enganoso de qualquer apresentação. Uma lista com várias centenas de transportadoras pode significar coisas bem diferentes, e só uma delas é o que você quer.

Algumas dessas companhias chegam por um GDS e podem ser reservadas e emitidas de ponta a ponta. Outras chegam por conexões NDC, em que a busca pode funcionar bem mas o atendimento depois da reserva — alterações, reembolsos parciais, inclusão de bagagem — ainda pode ser manual para aquela companhia. Outras são low cost cujo conteúdo é agregado de outro revendedor: dá para exibir, às vezes dá para reservar, e aí o bilhete chega por uma rota que você não controla, num prazo que você não consegue prometer ao cliente. E algumas estão na lista porque um dia uma tarifa apareceu numa resposta de busca.

Uma companhia que você consegue mostrar mas não consegue emitir não é cobertura. Para um produto de varejo é pior do que a ausência, porque o cliente escolhe, paga e depois fica esperando.

Hotéis têm o mesmo formato com outras palavras. A contagem de propriedades inclui as que o fornecedor mapeou e as que não mapeou; tarifas estáticas guardadas em cache na semana passada ao lado de disponibilidade ao vivo; quartos em allotment com prazo de release ao lado de inventário em free sale. Peça a contagem do que é reservável ao vivo nas cidades em que você vende, e pergunte como são unificados os duplicados entre os próprios fornecedores dele — o mesmo hotel aparecendo três vezes por três preços é um chamado de suporte esperando para acontecer.

O teste prático é estreito. Anote as vinte rotas e as vinte cidades de hotel que concentram a maior parte do seu volume — digamos São Paulo–Dubai, Rio–Lisboa, hotéis em Dubai e em Orlando — e peça ao fornecedor que mostre exatamente essas funcionando de ponta a ponta no sandbox: busca, preço, reserva, emissão ou confirmação, cancelamento. Quem tem profundidade faz isso sem drama. Quem tem só o slide começa a falar do slide.

O que testar no trial: caminhos de erro, não caminhos felizes

Todo sandbox reserva com sucesso uma passagem só de ida em classe econômica numa rota tranquila. Foi para demonstrar isso que o sandbox foi construído. O seu tráfego de produção vai passar uma parte relevante da vida nos outros caminhos, e o trial é o único momento barato para enxergá-los.

Use o trial para rodar esta lista e registre o que a API devolveu ao lado do que de fato era verdade depois:

  • Mudança de preço entre busca e reserva. A chamada de reserva falha, conclui pelo novo preço ou devolve uma resposta distinta pedindo confirmação? A sua interface consegue diferenciar os casos sem interpretar uma string de mensagem?
  • Oferta expirada. Busque, espere mais do que a validade da oferta informada pelo fornecedor e reserve. A expiração é um erro específico ou o mesmo erro de “fornecedor indisponível”?
  • Esgotado na reserva. Inventário que some entre o preço e a reserva. Em que estado fica a reserva, e a pré-autorização de pagamento é liberada?
  • Nova tentativa após timeout. Envie uma requisição de reserva, derrube a conexão antes da resposta e envie de novo. Agora você tem um PNR ou dois? Esse teste sozinho diz mais sobre um fornecedor do que todo o resto do trial somado.
  • Reserva criada, emissão falhou. A API consegue informar um PNR que existe mas não foi emitido, e diz qual é o prazo de emissão?
  • Falha parcial. Um pedido de hotel com vários quartos em que um confirma e outro não. Um ida e volta em que os dois trechos vêm de fontes diferentes.
  • Cancelamento fora da janela gratuita. A multa é informada antes de você confirmar, ou descoberta na fatura?
  • Fornecedor fora do ar. Pergunte ao fornecedor como simular uma queda. Se ele não souber, pergunte como os clientes dele descobriram o comportamento.

Em cada caso você está pontuando duas coisas. Primeiro: a API conta a verdade sobre o estado da reserva? Segundo: o seu código consegue agir sobre essa verdade sem que uma pessoa leia texto livre? Uma API que falha com clareza é mais fácil de conviver do que uma que dá certo de forma ambígua.

Escrevemos com mais detalhe sobre o lado aéreo em o que a documentação de API de reserva de voos não conta, e sobre como desenhar um cliente para fornecedores de hotel lentos em o texto sobre disponibilidade hoteleira. Os dois acompanham bem um plano de trial.

Perguntas que revelam um agregador raso

Não há nada de errado com um agregador. A maior parte do conteúdo de viagem chega à maior parte dos vendedores por meio de um. O risco é o agregador raso: uma camada que revende a API de outra camada, põe uma margem e não é dona nem do contrato com o fornecedor nem da mesa de operações. Quando algo quebra, a resposta precisa subir duas empresas e voltar.

Cinco perguntas trazem isso à tona rapidamente:

  1. Quem é o fornecedor contratual desta reserva? Em qual contrato com a companhia ou o hotel ela se apoia?
  2. Por qual código IATA e qual BSP o bilhete passa? Se a resposta for “de um parceiro”, pergunte quem recebe a ADM quando uma regra tarifária é violada.
  3. Quando eu chamo cancel, o que acontece do lado de vocês? Uma chamada automática ao fornecedor ou uma fila que uma pessoa pega?
  4. Posso ver o erro de origem? Uma camada rasa tende a achatar toda falha num único código, porque não entende por completo os erros que recebe.
  5. Para quem eu ligo quando uma reserva ao vivo trava, e para quem eles ligam? Conte os saltos.

Nenhuma dessas respostas desqualifica sozinha. O código IATA de um parceiro pode funcionar se o contrato disser com clareza quem arca com a nota de débito. O que importa é o fornecedor responder com precisão e rapidez. As respostas vagas de agora são as que você vai receber depois, em produção, num horário pior.

Quanto custa errar

A integração é a parte barata. As caras chegam depois e não aparecem em estimativa nenhuma.

Um bug de reserva duplicada significa um cliente cobrado duas vezes e um PNR para achar e cancelar na mão, talvez depois de fechada a janela gratuita de void. Uma reserva que deu certo na origem enquanto o seu lado registrou falha significa um assento segurado, depois cancelado automaticamente, e um cliente que acredita estar reservado. Uma companhia exibida mas não emitível significa reembolso, pedido de desculpas e um cliente que não volta. Uma ADM por uma regra tarifária que a rota do fornecedor quebrou cai em quem é dono do bilhete — tenha certeza, com antecedência, de se esse alguém é você.

Depois vem o custo de troca. Cada peculiaridade do fornecedor que você absorve — um código de status que significa duas coisas, um campo que às vezes é string — acaba no seu modelo de dados. Dois anos depois, a escolha da API não é mais uma integração que se troca numa sprint; é o formato da sua tabela de reservas. Esse é o motivo real para comparar com cuidado agora.

Onde a nossa API se encaixa nesse método

Oferecemos APIs de voos e de hotéis. O acesso começa por uma conversa, e não por uma chave self-service, o que alguns desenvolvedores acham lento; o motivo é que é nessa conversa que as perguntas acima são feitas nos dois sentidos — de quais rotas e cidades você precisa, que conteúdo você vai de fato conseguir emitir ou confirmar, e quem cuida do quê depois da reserva. Se você está fazendo uma comparação, leve esta lista. A página de APIs de viagem é onde essa conversa começa.

Seja qual for a escolha, faça-a a partir do registro do trial, e não da apresentação. A apresentação diz o que um fornecedor quer ser. Os caminhos de erro dizem o que ele é.

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.