API de códigos ICAO de companhias aéreas

Identifique companhias aéreas a partir dos códigos ICAO de três letras presentes nos seus dados de aviação. Obtenha os nomes das companhias aéreas e os códigos IATA correspondentes, ou descarregue o diretório para fazer corresponder registos na sua própria aplicação.

Chave de API de teste Ver exemplo
  • Consulta por código ou nome
  • JSON, XML e CSV
  • Registos individuais ou exportação completa

Consultar uma companhia aérea pelo código ICAO

Envie um código de companhia aérea de três letras no parâmetro icao da API de companhias aéreas. Este exemplo consulta a Southwest Airlines com SWA. 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 'icao=SWA'

Resposta · excerto JSON

[
  {
    "iata": "WN",
    "icao": "SWA",
    "marketing_name": "Southwest Airlines",
    ...
  }
]

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

Utilize estes parâmetros de consulta para procurar códigos de companhias aéreas ou exportar o diretório.

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 WN.
icao CondicionalNenhumConsulta uma companhia aérea pelo código ICAO de três letras, por exemplo SWA.
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 icao para identificar uma companhia aérea e iata para a fazer corresponder aos dados do sistema de reservas, quando existir um código IATA. Os campos selecionados abaixo seguem a ordem da referência da API principal.

CampoTipoExemploDescrição
airhex_id Identificador1046Identificador permanente do registo na Airhex. Utilize-o para associar atualizações futuras ao mesmo registo.
iata StringWNDesignador IATA da companhia aérea, com dois caracteres. Os códigos podem conter letras e dígitos; guarde-os como texto.
icao StringSWADesignador ICAO da companhia aérea, com três letras, útil para fazer corresponder sistemas de códigos.
marketing_name StringSouthwest 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.

Ver todos os dados disponíveis →

Tarefas de implementação mais comuns

Descarregar o diretório de códigos de companhias aéreas

Utilize dump=1 para exportar a base de dados. Acrescente onlyscheduled=0 para incluir todos os tipos de companhias aéreas, em vez do filtro predefinido de companhias aéreas regulares. Este exemplo em CSV pode ser importado para a sua própria base de dados; ao criar uma consulta ICAO, conserve os registos com o campo icao preenchido. Verifique type_code se precisar de excluir outros tipos de transportadoras, como registos de comboio, autocarro e ferry.

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 airlines.csv

Encontrar um código ICAO a partir do nome de uma companhia aérea

Pesquise com name e leia icao em cada registo devolvido. As pesquisas por nome admitem correspondências parciais; por isso, reveja as identidades devolvidas em vez de assumir que o primeiro resultado é a única correspondência.

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

Fazer corresponder um código IATA a um código ICAO

Envie o designador IATA em iata e leia o campo icao devolvido. Por exemplo, utilize WN, vindo de um fornecedor de reservas, para encontrar SWA e fazer a correspondência com um conjunto de dados de aviação.

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

O que pode criar

Enriquecimento de dados de aviação

Transforme os códigos ICAO de companhias aéreas de um conjunto de dados de aviação em nomes legíveis para painéis e relatórios.

Ligar dados de reservas e de aviação

Faça corresponder identificadores IATA de fornecedores de reservas a identificadores ICAO de outras fontes, verificando que ambos os registos se referem à companhia pretendida.

Diretórios de operadores

Crie uma consulta local de companhias aéreas para operadores regulares, de carga ou charter, com filtros explícitos de tipo e de estado operacional.

Perguntas frequentes

O que é um código ICAO de companhia aérea?

É um designador de companhia aérea com três letras, como SWA para a Southwest Airlines. Esta página trata de identificadores de companhias aéreas; para identificadores de aeroportos, utilize a API de aeroportos.

Em que diferem os códigos ICAO de companhias aéreas dos códigos IATA?

Os designadores ICAO de companhias aéreas têm três letras, enquanto os designadores IATA têm dois caracteres e podem incluir dígitos. A API de companhias aéreas fornece ambos os campos, quando disponíveis. Utilize o parâmetro que corresponde ao sistema de códigos da sua fonte de dados: envie os códigos ICAO em icao e os códigos IATA em iata.

Posso converter entre códigos ICAO e IATA de companhias aéreas?

Consulte um código ICAO com icao e leia iata no resultado, ou consulte um código IATA com iata e leia icao. Verifique se o campo de destino está preenchido antes de usar a correspondência; não parta do princípio de que todos os registos têm ambos os códigos. Conserve o código ICAO e a identidade da companhia aérea mesmo quando faltar a correspondência IATA.

Posso consultar operadores de carga e charter?

Defina onlyscheduled=0 para incluir tipos de companhias aéreas para além do filtro predefinido de companhias regulares. Verifique type_code para selecionar as categorias de operadores de que precisa e status se a sua aplicação só deva incluir companhias ativas. O valor predefinido onlyscheduled=1 seleciona as companhias aéreas regulares.

O campo parent_icao identifica a companhia operadora de um voo?

Não. A referência da API principal define parent_icao como o código ICAO de uma companhia aérea-mãe, quando aplicável. Para identificar a companhia operadora de um voo específico, utilize o identificador da companhia fornecido pelo seu fornecedor de voos e consulte essa companhia em separado.

Como devo tratar uma consulta sem resultado?

Conserve o código original da fonte como alternativa quando não conseguir resolver uma companhia aérea e trate as falhas de pedido em separado das correspondências em falta. Nas pesquisas parciais por nome, compare os nomes e os códigos devolvidos antes de selecionar um registo.

Posso manter um diretório ICAO de companhias aéreas na minha própria base de dados?

Sim, com uma licença adequada da base de dados de companhias aéreas. Exporte com dump=1 em JSON, XML ou CSV e conserve os campos de que a sua integração precisa. Guarde airhex_id com as correspondências de códigos e atualize periodicamente a sua cópia. A Airhex revê e atualiza diariamente os dados das companhias aéreas; a API de alterações disponibiliza um registo de alterações recentes. Conserve a data e hora updated da resposta completa ao atualizar os registos.

Este endpoint fornece rastreio ou estado de voos em tempo real?

Não. Fornece dados de referência de companhias aéreas para identificar companhias e fazer corresponder códigos. Obtenha informação de voos em tempo real junto do seu fornecedor de dados de voos. O campo status devolvido descreve o estado operacional da companhia aérea, não o de um voo individual.

Crie a sua consulta ICAO de companhias aéreas

Faça corresponder identidades de companhias aéreas entre fontes de dados de aviação e mantenha os nomes das companhias consistentes nos seus painéis, relatórios e ferramentas para passageiros.

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 alianças aéreas →

Consulte a aliança de uma companhia aérea por código IATA, ICAO ou nome. Crie filtros de alianças e agrupe companhias na sua aplicação com a Airhex.

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.