Diretório de integrações
Integração da API Amadeus: o conector de voos, passo a passo
O módulo Amadeus conecta a busca de voos do PHPTRAVELS ao Amadeus Enterprise. Registre um app, cole três credenciais no admin, teste em modo de desenvolvimento e passe para produção quando a Amadeus aprovar sua conta.
- Conector do plano Enterprise
- OAuth2 client credentials
- Desenvolvimento e produção
- Guia de configuração publicado
Configuração do conector
Do app Amadeus a resultados de voos ao vivo em cinco passos
O conector é um módulo pronto, por isso uma configuração padrão não exige escrever código. Você traz sua conta Amadeus e as suas condições comerciais, e o módulo trata da autenticação, da busca de voos e da criação de pedidos dentro do módulo de voos do PHPTRAVELS.
- Comece no plano Enterprise, que inclui o módulo Amadeus
- Registre-se no Amadeus for Developers e crie um app com Flight Offers Search e Flight Create Orders
- Insira grant type, client ID e client secret em Módulos no admin, com Dev mode ativo
- Pesquise voos no seu site e confirme o logotipo Amadeus por baixo do botão Reservar agora
- Solicite as chaves de produção, substitua as de sandbox e mude o Dev mode para produção
- Dev mode
- Desenvolvimento
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
O que o conector faz
Ofertas Amadeus na sua busca, pedidos no seu admin
Duas APIs da Amadeus movem o módulo: uma devolve ofertas de voos para a página de resultados e a outra cria a reserva quando o viajante paga.
- APILondres a Nova York · DiretoEconômica · 8 h 05 min · 1 bagagem despachadaUS$ 486por adulto
- v2Londres a Nova York · 1 escalaEconômica · 11 h 20 min via Dublin · 1 bagagem despachadaUS$ 412por adulto
- Londres a Nova York · DiretoExecutiva · 7 h 55 min · 2 bagagens despachadasUS$ 2.140por adulto
Flight Offers Search e Flight Create Orders
Offers Search preenche os resultados; Create Orders transforma a oferta escolhida numa reserva. Ative ambas no seu app Amadeus para pesquisar e reservar.
Autenticação OAuth2
O módulo pede tokens de acesso com o grant client_credentials, usando o client ID e o secret que você insere no admin.
Modos de desenvolvimento e produção
Uma única definição, Dev mode, decide se os pedidos usam as chaves sandbox ou as chaves de produção aprovadas.
Endpoint Enterprise
O módulo assenta em travel.api.amadeus.com/v2/. Algumas regiões usam outro endpoint, por isso confirme o seu antes de inserir as chaves.
Origem visível em cada resultado
Um logotipo Amadeus por baixo do botão Reservar agora mostra que tarifas vêm da Amadeus, para verificar a conexão num relance.
Causas de erro conhecidas
A maioria das falhas são credenciais erradas, um modo que não corresponde às chaves ou um serviço de API inativo no painel da Amadeus.
Fluxo de pedidos
O que acontece em cada pesquisa na Amadeus
A mesma sequência corre em desenvolvimento e em produção; só mudam as chaves e a definição Dev mode.
Autenticar
Seu client ID e secret são trocados por um token de acesso.
Pesquisar
Flight Offers Search devolve tarifas para a rota, as datas e os passageiros.
Mostrar
As ofertas aparecem com a sua margem, ao lado dos resultados de outros fornecedores conectados.
Pedir
Flight Create Orders reserva a oferta escolhida com os dados do viajante.
Registrar
A reserva fica salva no admin e a confirmação é enviada por email.
Onde a Amadeus se encaixa
A sua conta Amadeus, outras APIs de voos e desenvolvimento sob medida
O módulo Amadeus é um de vários conectores de voos, e cada um funciona com as suas próprias credenciais na mesma pesquisa.
A sua conta Amadeus Enterprise
A Amadeus emite as chaves de produção depois de rever o seu caso de uso, o registro da empresa e o site, e você aceita as condições comerciais.
Outros conectores de voos
Adicione Duffel, Kiwi ou outros fornecedores de voos a partir do diretório de integrações e compare tarifas numa só lista.
Outros endpoints e APIs
Um endpoint regional da Amadeus ou uma API que o módulo ainda não usa pode ser adicionado como desenvolvimento sob medida.
Fornecedores de voos que você pode conectar:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
Back office
Gerencie as reservas Amadeus a partir do mesmo admin
Com as chaves inseridas, as tarifas Amadeus seguem as regras que já usa para qualquer outro fornecedor de voos.
Margens de voos
Adicione margens fixas ou percentuais para que as tarifas Amadeus mostrem o seu preço de venda.
Lista de reservas
As reservas Amadeus aparecem com dados do viajante e estado no tela de reservas de voos.
Agentes B2B
Os agentes pesquisam e reservam tarifas Amadeus no portal de agentes com as suas próprias tarifas.
Pagamentos
Os viajantes pagam pelos gateways que ativou, ou os agentes pela carteira.
Chaves no seu servidor
As credenciais ficam salvas no seu próprio admin auto-hospedado, não numa plataforma partilhada.
Tickets de suporte
Abra um ticket em app.phptravels.com se uma conexão ou reserva precisar da nossa ajuda.
Comparar
Programar sobre a Amadeus por conta própria vs o módulo PHPTRAVELS
Ambos usam a mesma conta Amadeus. A diferença é quanto a sua equipe escreve e mantém à volta dela.
| Tarefa | Integração direta da API | PHPTRAVELS |
|---|---|---|
| Autenticação | Integração direta da APIPedidos e renovação de tokens escritos pelos seus desenvolvedores | PHPTRAVELSTratada pelo módulo a partir de três campos do admin |
| Resultados de pesquisa | Integração direta da APIDados das ofertas mapeados para a sua própria página de resultados | PHPTRAVELSOfertas mostradas na pesquisa de voos existente |
| Reserva | Integração direta da APIFormulários de viajantes e chamadas de pedido feitos do zero | PHPTRAVELSCreate Orders conectado ao checkout e ao pagamento |
| Teste e produção | Integração direta da APIConfiguração separada para cada ambiente | PHPTRAVELSUm único interruptor Dev mode |
| Margens e reservas | Integração direta da APIUm back office por desenhar e construir | PHPTRAVELSIncluído no admin de voos |
| Passos de configuração | Integração direta da APIEscritos e atualizados pela sua equipe | PHPTRAVELSGuia publicado em docs.phptravels.com |
Casos de uso
Quem ativa o módulo Amadeus
Agências de viagens online
Pesquisa pública de voos com conteúdo Amadeus, com a sua margem e o seu checkout.
Redes de agentes B2B
Os subagentes reservam tarifas Amadeus no seu portal com as suas tarifas.
Empresas de gestão de viagens
Os gestores de viagens corporativas pesquisam tarifas Amadeus numa plataforma que você hospeda e controla.
Por que PHPTRAVELS
Um conector que pode ler, alterar e hospedar
Código-fonte incluído
Auto-hospedado com licença comercial, para que os desenvolvedores possam expandir o módulo Amadeus.
Configuração documentada
Cada passo, campo e causa de erro está descrito em docs.phptravels.com.
24 idiomas
Mostre tarifas Amadeus nos idiomas dos seus mercados, incluindo os da direita para a esquerda.
B2C e B2B
Uma instalação para o seu site público e o portal de agentes.
Perguntas frequentes
Perguntas sobre o conector Amadeus
O que as equipes perguntam ao configurar o módulo Amadeus.
Fale com vendasÉ um módulo de voos pronto. Você cria um app no Amadeus for Developers, insere as credenciais no admin e as ofertas Amadeus aparecem na sua pesquisa de voos, com reservas criadas através de Flight Create Orders.
O módulo Amadeus está disponível com o plano Enterprise, um pagamento único de $9999 indicado na página de preços. A sua conta Amadeus e as respetivas condições comerciais são à parte e acordadas com a Amadeus.
Um grant type client_credentials, um client ID e um client secret. A Amadeus emite chaves sandbox quando você cria um app e chaves de produção depois de aprovar o pedido de produção.
O módulo usa travel.api.amadeus.com/v2/. Algumas regiões têm outro endpoint ou parâmetros, por isso verifique primeiro sua conta; outros endpoints podem ser adicionados como desenvolvimento sob medida.
Ambos, conforme as APIs ativas no seu app Amadeus. Flight Offers Search dá os resultados e Flight Create Orders precisa estar ativa para as reservas.
O conector documentado é para voos. A Amadeus também consta como fornecedor de alojamento, mas o guia de configuração ainda não foi publicado, por isso fale com a nossa equipe sobre o âmbito de hotéis.
Continue a explorar
Mais sobre a plataforma
- Integração da API AmadeusVoos, hotéis e carros da Amadeus no seu portal
- Integração da API DuffelOfertas e pedidos de voos Duffel no seu site de reservas
- Integração API da KiwiPesquisa e reserva de voos Kiwi.com Tequila
- VoosEmissão via GDS e NDC
- Preços
- Todas as integraçõesA lista completa e sempre atualizada
