API de estado de companhias aéreas

Verifique se uma companhia aérea está ativa, inativa ou em fase de arranque, a aguardar o início de operações. Obtenha o estado operacional juntamente com os códigos e nomes das companhias para manter o seu diretório e criar seletores adequados.

Chave de API de teste Ver exemplo
  • Ativa, inativa e em fase de arranque
  • Consulta por código ou nome
  • JSON, XML e CSV

Verificar o estado operacional de uma companhia aérea

Consulte a Southwest Airlines com o código IATA WN e leia o campo status. O valor 1 significa que a companhia aérea está ativa. 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=WN'

Resposta · excerto JSON

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

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 descarregue o diretório e leia o campo status na resposta. O endpoint documentado não tem um parâmetro de consulta de estado; aplique os filtros de estado 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 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

Leia status em conjunto com a identidade da companhia aérea. Os valores são 1 para ativa, 0 para inativa e 2 para uma companhia em fase de arranque, a aguardar o início das operações. Conserve airhex_id ao manter os seus registos locais.

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, a aguardar o início das operações.

Ver todos os dados disponíveis →

Tarefas de implementação mais comuns

Descarregar o diretório e filtrar por estado

Exporte o diretório em CSV e filtre a coluna status na sua aplicação: conserve 1 para companhias ativas, 0 para companhias inativas ou 2 para companhias em fase de arranque. Definir onlyscheduled=0 alarga a cobertura de tipos de companhias aéreas; não é um filtro de companhias ativas. Verifique type_code se precisar de excluir registos de comboio, autocarro ou 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 airline-status.csv

Encontrar o estado de uma companhia aérea pelo nome

Pesquise com name, selecione a companhia pretendida entre os registos correspondentes e leia status. A correspondência parcial por nome pode devolver mais do que uma companhia aérea. Inclua onlyscheduled=0 se quiser pesquisar para além das companhias regulares.

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

Verificar o estado através de um código ICAO

Utilize icao quando a sua fonte identificar a companhia com um código ICAO de três letras. Este exemplo obtém a Southwest Airlines com SWA. Leia o valor de status devolvido, em vez de deduzir o estado operacional da existência de um código.

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

O que pode criar

Verificar companhias ativas nas suas ferramentas de reserva

Crie um seletor a partir de registos com status 1, aplicando os filtros de tipo de companhia de que o seu produto precisa.

Relatórios históricos de viagens

Conserve as identidades de companhias inativas para explicar reservas, itinerários e registos de transações mais antigos.

Manutenção do diretório

Compare os registos atualizados por airhex_id e assinale as alterações de estado para revisão nas suas ferramentas internas.

Perguntas frequentes

O que significam os valores de estado das companhias aéreas?

1 significa ativa, 0 significa inativa e 2 significa uma companhia em fase de arranque, a aguardar o início das operações. Estes valores descrevem a companhia aérea enquanto organização.

O estado ativa significa que um voo está disponível para reserva?

Não. O estado ativa de uma companhia aérea não garante disponibilidade numa rota ou numa data. Recorra ao seu fornecedor de reservas para a disponibilidade de voos e as tarifas.

Posso pedir apenas companhias aéreas ativas?

A API de companhias aéreas documentada não tem um parâmetro de consulta de estado. Obtenha os registos de que precisa e filtre por status igual a 1 na sua aplicação. onlyscheduled=1 seleciona tipos de companhias regulares; não substitui a verificação do estado. Compare explicitamente com 1: uma verificação de valor diferente de zero incluiria também as companhias em fase de arranque, com status 2.

Como posso encontrar companhias aéreas inativas ou em fase de arranque?

Exporte o diretório e filtre os registos devolvidos por status 0 ou 2. Defina onlyscheduled=0 se precisar de todos os tipos de companhias. Para uma companhia individual, consulte o código ou o nome e verifique o estado devolvido.

Um código de companhia aérea em falta significa que a companhia deixou de operar?

Não. Um código em falta ou uma consulta sem resultado não é um valor de estado operacional. Conserve o identificador original e investigue a correspondência, em vez de classificar a companhia como inativa. Atribua uma classificação operacional apenas quando um registo devolvido fornecer um valor de estado reconhecido.

Devo remover as companhias aéreas inativas da minha base de dados?

Conserve os registos de que precisa para resolver reservas ou relatórios históricos. Pode excluir os registos com status 0 dos seletores atuais sem apagar a sua identidade histórica. Utilize airhex_id para associar futuras importações aos registos existentes.

Como mantenho atualizado o estado das companhias aéreas?

A Airhex revê e atualiza diariamente os dados das companhias aéreas. Atualize periodicamente os seus registos locais e conserve airhex_id e a data e hora updated da resposta completa. A API de alterações disponibiliza um registo de alterações recentes, incluindo alterações de estado, para apoiar o acompanhamento.

Esta é uma API de estado de voos em tempo real?

Não. Fornece o estado operacional das companhias aéreas, não partidas, chegadas, atrasos ou cancelamentos. Recorra a um fornecedor de dados de voos para o estado de cada voo.

Mantenha o seu diretório de companhias aéreas atualizado

Mantenha as companhias ativas visíveis nos seletores atuais, conservando as identidades das companhias inativas para reservas e relatórios históricos.

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.