API de alianças aéreas

Ajude os viajantes a encontrar companhias aéreas na aliança que preferem. Obtenha a adesão a alianças juntamente com os nomes e códigos das companhias para acrescentar etiquetas de alianças, filtros e comparações de companhias à sua aplicação de viagens.

Chave de API de teste Ver exemplo
  • Adesão a alianças aéreas
  • Consulta por código ou nome
  • JSON, XML e CSV

Consultar a aliança de uma companhia aérea

Consulte a United Airlines com o código IATA UA e leia alliance. Este exemplo devolve Star Alliance. Substitua YOUR_API_KEY pela chave atribuída.

Pedido · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'iata=UA'

Resposta · excerto JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "alliance": "Star Alliance",
    ...
  }
]

Resposta abreviada. As reticências (…) representam outros campos da companhia aérea omitidos aqui e não fazem parte da resposta JSON real.

Ver a referência completa: API de companhias aéreas →

Parâmetros do pedido

Consulte uma companhia aérea ou exporte o diretório e leia alliance nos registos devolvidos. O endpoint documentado não tem um parâmetro de consulta de aliança; agrupe ou filtre os registos na sua aplicação.

ParâmetroObrigatórioPredefiniçãoDescrição
apikey SimNenhumA sua chave de API atribuída. Obter chave de API de teste gratuita.
iata CondicionalNenhumConsulta uma companhia aérea pelo código IATA de dois caracteres, por exemplo UA.
icao CondicionalNenhumConsulta uma companhia aérea pelo código ICAO de três letras, por exemplo UAL.
name CondicionalNenhumProcura códigos de companhias aéreas pelo nome completo ou parcial.
dump Condicional0Defina 1 para exportar o conjunto de dados completo, sujeito ao filtro onlyscheduled.
response_type NãoJSONFormato da resposta: JSON, XML ou CSV. CSV inicia a descarga de um ficheiro.
onlyscheduled Não1Defina 1 apenas para companhias aéreas regulares ou 0 para todos os tipos de companhias aéreas.

Indique pelo menos um dos parâmetros iata, icao, name ou dump=1. Com dump=1, os restantes parâmetros de consulta são ignorados.

Ver todos os parâmetros do pedido →

Dados disponíveis

Utilize alliance para apresentar a adesão juntamente com a identidade da companhia aérea. Conserve status ao criar um diretório de membros ativos e airhex_id ao atualizar os seus registos locais.

CampoTipoExemploDescrição
airhex_id String965Identificador permanente do registo na Airhex. Utilize-o para associar atualizações futuras ao mesmo registo.
iata StringUADesignador IATA da companhia aérea, com dois caracteres. Os códigos podem conter letras e dígitos; guarde-os como texto.
icao StringUALDesignador ICAO da companhia aérea, com três letras, útil para fazer corresponder sistemas de códigos.
marketing_name StringUnited AirlinesNome da companhia aérea habitualmente usado, para apresentação na sua aplicação.
status Integer1Estado operacional: 1 = ativa, 0 = inativa, 2 = em fase de arranque.
alliance StringStar AllianceAliança aérea a que a companhia pertence, quando aplicável.

Ver todos os dados disponíveis →

Tarefas de implementação mais comuns

Descarregar o diretório e agrupar as companhias aéreas por aliança

Exporte o diretório em CSV e agrupe os registos pelo campo alliance na sua aplicação. Filtre pelo nome da aliança devolvido para criar uma lista de membros e verifique status se quiser apenas companhias ativas. onlyscheduled=0 alarga a cobertura de tipos de companhias; verifique type_code para selecionar os registos de que o seu produto precisa.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'dump=1' \
  --data-urlencode 'onlyscheduled=0' \
  --data-urlencode 'response_type=CSV' \
  --output airline-alliances.csv

Encontrar a adesão a uma aliança pelo nome da companhia aérea

Pesquise com name, selecione a companhia pretendida e leia alliance. A correspondência parcial por nome pode devolver vários registos; confirme a identidade da companhia antes de apresentar a sua adesão.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'name=United'

Obter a adesão a uma aliança através de um código ICAO

Utilize icao quando a sua fonte fornecer um código ICAO de companhia aérea com três letras. Este exemplo obtém a United Airlines com UAL e lê alliance no mesmo registo da companhia.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'icao=UAL'

O que pode criar

Filtros de alianças na pesquisa de voos

Faça corresponder os códigos de companhias aéreas dos fornecedores ao seu diretório e permita que os viajantes restrinjam os resultados por aliança aérea, com um tratamento claro das companhias comercializadora e operadora.

Páginas de comparação de companhias aéreas

Apresente a aliança indicada junto ao nome de cada companhia aérea para ajudar os viajantes a compará-las.

Diretórios de membros de alianças

Agrupe os registos das companhias aéreas por adesão para criar listas navegáveis e relatórios internos.

Perguntas frequentes

O que devolve a API de alianças aéreas?

O campo alliance identifica a adesão a uma aliança indicada para a companhia aérea, quando aplicável. Faz parte do registo da API de companhias aéreas, juntamente com os nomes das companhias, os códigos IATA, os códigos ICAO e outros dados de referência.

Posso obter todas as companhias aéreas de uma aliança em particular?

Exporte o diretório com dump=1 e filtre os valores de alliance devolvidos na sua aplicação. O endpoint documentado não tem um parâmetro de pedido de aliança. Verifique status se a lista de membros só deva incluir companhias ativas. Crie grupos a partir dos valores de alliance preenchidos e conserve os nomes e os códigos das companhias em cada registo para fazer corresponder as companhias nos resultados de pesquisa.

Posso consultar a adesão por código IATA, código ICAO ou nome?

Sim. Utilize iata, icao ou name para obter os registos das companhias aéreas e leia depois alliance. A correspondência por nome admite pesquisas parciais; selecione a companhia pretendida antes de usar o resultado.

O que devo mostrar quando alliance está vazio?

Omita a etiqueta da aliança ou mostre “Sem aliança indicada”, de acordo com o design do seu produto. Não deduza a adesão a partir de uma companhia aérea-mãe, de um parceiro de codeshare ou de um nome de companhia semelhante.

Pertencer a uma aliança significa que o passageiro acumula milhas ou tem acesso a salas VIP?

Não. Este campo descreve a adesão da companhia aérea e não determina benefícios para um passageiro ou bilhete em particular. Utilize as regras do programa de fidelização aplicável e os dados da reserva para determinar a elegibilidade.

Como devem os filtros de alianças tratar os voos em codeshare?

Decida se o filtro se aplica à companhia comercializadora, à companhia operadora ou a ambas e explique essa escolha aos viajantes. Consulte separadamente cada companhia fornecida com o itinerário; o campo alliance não determina as relações de codeshare de um voo.

Posso guardar a adesão a alianças na minha própria base de dados?

Sim, com uma licença adequada da base de dados de companhias aéreas. Exporte em JSON, XML ou CSV e conserve a identidade da companhia aérea com o respetivo valor de alliance. Atualize periodicamente o seu diretório; a Airhex revê e atualiza diariamente os dados das companhias aéreas. Guarde airhex_id e a data e hora updated da resposta completa para captar alterações de adesão e de estado das companhias.

Esta API devolve a adesão histórica a alianças?

O campo alliance documentado indica a adesão registada na companhia aérea. Não fornece intervalos de datas de adesão nem uma consulta a uma data determinada. Conserve os seus próprios registos datados se os seus relatórios exigirem comparações históricas.

Ajude os viajantes a encontrar companhias aéreas na aliança que preferem

Acrescente filtros de alianças e etiquetas de adesão ao seu produto de viagens sem ter de manter listas de adesão das companhias aéreas.

Chave de API de testePedir orçamento →

API de companhias aéreas →

Explore o conjunto de dados completo de companhias aéreas: códigos IATA e ICAO, nomes, estado operacional, tipos de companhias aéreas, alianças, programas de passageiro frequente, ligações de check-in e de política de bagagem, logótipos e cores da marca. Consulte todos os parâmetros do pedido e campos da resposta, com consultas individuais e exportações completas em JSON, XML e CSV.

API de estado de companhias aéreas →

Consulte o estado operacional das companhias aéreas (ativa, inativa ou em fase de arranque) por código ou nome e filtre o seu diretório local com a Airhex.