Pular para o conteúdo
Blog

Alternativa à API Amadeus Self-Service: migrar em uma semana

Redação Tekravel
Escrito com a ajuda de IA

Você descobre por um health check que falhou, ou por um usuário. O endpoint de busca que o seu app de voos chama desde o primeiro protótipo devolve um erro que você nunca tinha visto, e o portal onde você gerenciava suas chaves não existe mais. Se você está procurando uma alternativa à API Amadeus Self-Service, provavelmente está exatamente nesse ponto: um produto funcionando, um código moldado em torno das requisições de um único fornecedor e pouco tempo antes que os usuários percebam que a busca quebrou.

Sobre o fornecedor, vale registrar um único fato. A Amadeus desativou o portal Self-Service API em 17 de julho de 2026, e os novos desenvolvedores são encaminhados ao canal Enterprise, que funciona por contrato. Este texto não vai dizer mais nada sobre os motivos. A pergunta útil é o que entra no lugar e como migrar em mais ou menos uma semana sem reconstruir o que ainda funciona.

O que o self-service realmente te dava

É fácil lembrar do portal antigo como "uma API de voos" e sair procurando outra API de voos. Isso ignora o que o tornava útil para uma startup de duas pessoas ou para um projeto de fim de semana. Basicamente, três coisas:

  • Um modo de teste acessível em uma tarde. Cadastro, chave, chamada de busca. Ninguém perguntava o que a sua empresa fazia.
  • Cobrança por uso. Você pagava pelo que chamava; um produto com cem usuários custava o que um produto com cem usuários deve custar.
  • Nenhum ciclo de vendas. Ninguém precisava te aprovar antes de você escrever código.

Um contrato enterprise inverte as três coisas. O acesso vem depois de uma conversa comercial, o preço é negociado e o ambiente de testes chega junto com a papelada. Nada disso é absurdo do lado de quem vende: distribuir conteúdo aéreo envolve obrigações reais. Mas o seu plano muda. Se você contava em trocar uma chave de API por outra, a resposta honesta é que a maioria das alternativas sérias não funciona mais assim, inclusive a que este site oferece. Voltamos a isso mais abaixo.

Três caminhos para uma alternativa à API Amadeus Self-Service

Tire os nomes das marcas e sobram três tipos de substituto. Eles se diferenciam menos pelo JSON do que por com quem você assina e quem, no fim, emite o bilhete.

CaminhoTempo até a primeira reserva realConteúdo esperadoQuem detém a placa de emissão
Contrato direto com um GDSO mais longo: análise comercial, certificação e depois o desenvolvimentoAmplo conteúdo GDS; NDC e low cost dependem do contratoVocê, se tiver credenciamento IATA; senão, continua precisando de alguém que tenha
API de um agregadorIntermediário: onboarding mais leve, mas espere um contratoUma mistura de GDS, NDC e LCC, conforme as fontes que o agregador conectouNormalmente o próprio agregador ou um parceiro de emissão dele
API de um consolidadorMuitas vezes o caminho mais curto até um bilhete emitido, porque a emissão já está resolvidaO que o consolidador vende: suas tarifas negociadas e net, mais o que os fornecedores dele trazemO consolidador, com o próprio credenciamento

Dá para discordar da coluna do meio, e para o seu caso você deve. Uma equipe que já tem credenciamento e uma pessoa comercial na casa pode achar o caminho GDS mais rápido do que a tabela sugere. Mas a maioria dos desenvolvedores que construiu em cima de um sandbox self-service nunca teve placa de emissão, e é a última coluna que decide quanto do seu produto continua funcionando depois da migração.

O motivo é este. Busca e cotação são operações de leitura; os três caminhos entregam isso. Emitir um bilhete é um ato financeiro, feito sob o credenciamento de alguém e liquidado pelo BSP ou equivalente, e se esse alguém não é você, é preciso um acordo com quem for. Equipes que pulam essa pergunta terminam com uma página de busca bonita e um botão de reservar que cria uma reserva que ninguém paga.

Conteúdo é a outra coluna para ler devagar. Conteúdo GDS e conteúdo NDC não são as mesmas tarifas, e as low cost muitas vezes não estão em nenhum dos dois. Se os seus usuários voam principalmente trechos domésticos no Brasil, onde as companhias de baixo custo pesam muito, mesmo um caminho com excelente cobertura GDS pode trazer resultados fracos. Explicamos essa diferença em NDC API ou GDS: o que mudou para quem integra.

Como o acesso funciona aqui, e por que também não é uma chave

Esta plataforma oferece APIs de voos e hotéis. O acesso começa com uma conversa, não com uma chave self-service. Dizemos isso com todas as letras porque o pior que pode te acontecer esta semana é se cadastrar em algum lugar esperando a experiência antiga e descobrir no quarto dia que existe uma aprovação humana no caminho.

A conversa gira principalmente em torno das perguntas da tabela: o que você está construindo, quem são seus usuários, se você precisa de emissão ou só de busca e preço, e em quais mercados você vende. Essas respostas definem o conteúdo que você recebe e como as reservas são liquidadas. Se quiser começar, a página de APIs de viagem é o ponto de partida.

Seja qual for o fornecedor, faça a mesma pergunta no primeiro e-mail: existe uma chave de teste self-service, e o que precisa acontecer antes da produção? Uma resposta clara é bom sinal para o resto da integração. Uma resposta vaga também diz alguma coisa.

Checklist de migração, na ordem em que as coisas quebram

A maioria das integrações self-service tinha o mesmo formato: buscar, cotar, criar o pedido, emitir e depois lidar com tudo o que acontece quando o bilhete já existe. Teste de novo cada etapa contra o novo fornecedor como se você nunca a tivesse escrito. Os nomes das requisições vão mudar; o que morde são as suposições enterradas no seu código.

  1. Busca. Mapeie o seu modelo de consulta (origem, destino, datas, passageiros, cabine) para a nova requisição. Confira como passam as idades de crianças e bebês, se multidestino é uma chamada separada e como é um resultado vazio. Lista vazia e erro são coisas diferentes, e a sua interface provavelmente trata as duas do mesmo jeito.
  2. Identidade da oferta. Descubra por quanto tempo um id de oferta continua válido e se ele sobrevive a um recarregamento de página. Código que guardava a oferta na sessão e cotava dez minutos depois vai falhar de jeitos novos.
  3. Preço. Recotar antes de reservar não é opcional na maioria dos fornecedores. Trate o caso em que o preço mudou e decida o que o usuário vê quando isso acontece.
  4. Pedido. Nomes dos passageiros, campos de documento, dados de contato. Valide os formatos do seu lado antes de enviar; um pedido recusado depois que o cliente pagou é o bug mais caro desta lista.
  5. Bilhete. Confirme se a chamada de pedido também emite ou se a emissão é uma etapa separada, com prazo próprio. Saiba em qual placa o bilhete vai sair antes de receber o dinheiro de qualquer pessoa.
  6. Pós-emissão. Cancelamento, void, reembolso, alteração de horário. São as chamadas de que um protótipo nunca precisou e de que um produto no ar precisa já no primeiro mês. Pergunte se elas existem na API ou passam por uma equipe de suporte.

Para um plano de testes mais completo, incluindo o que pode ser simulado e o que nunca deve ser, veja nosso plano de testes de APIs de viagem em sandbox. Se você chega pelo lado da integração, a integração de uma API de reserva de voos percorre o fluxo inteiro.

Quanto custa uma migração apressada

A tentação é embrulhar o novo fornecedor atrás da sua antiga interface de cliente e publicar assim que a busca devolver resultados. A busca vai parecer ótima. O que falha é tudo o que a demo não mostrou.

Um preço que mudou entre a busca e o pedido, exibido ao usuário como erro cru, faz você perder a reserva. Um pedido criado sem emissão, porque o novo fornecedor separa as duas etapas e o seu código não, deixa um passageiro achando que tem bilhete quando não tem. Um fluxo de reembolso que, em silêncio, não faz nada até alguém escrever para o suporte vira chargeback. Cada um desses problemas dá para aguentar uma vez. Repetidos em toda a base de usuários, eles custam a confiança da qual vive um produto de viagens pequeno.

Existe ainda um custo mais discreto. Se você escolhe um caminho porque era o mais rápido esta semana e ele não traz o conteúdo que os seus usuários buscam, vai migrar duas vezes. Um dia gasto nas perguntas de conteúdo e emissão antes de qualquer linha de código é o seguro mais barato de todo o processo.

Uma semana, mais ou menos

O primeiro dia fica para as perguntas: qual caminho, qual conteúdo, qual placa. O segundo e o terceiro, para busca e preço com o novo fornecedor. O quarto, para pedido e emissão de ponta a ponta, incluindo os casos de erro. O quinto, para o pós-emissão e para ler os seus próprios logs. Se a conversa com um fornecedor demorar mais de um dia, comece a programar em cima da documentação dele em paralelo; o formato das requisições raramente muda depois que você o viu.

Não vai parecer a tarde que você levou para conseguir a sua primeira chave self-service. Nem precisa. O que você está construindo agora tem que emitir bilhetes pelos quais alguém responde.

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.