Parâmetros do pedido
Consulte uma companhia aérea ou exporte o diretório e leia lowcost, type e type_code. Utilize onlyscheduled para controlar a cobertura de tipos. O endpoint documentado não tem parâmetros de consulta lowcost ou type_code; aplique esses filtros aos registos devolvidos na sua aplicação.
| Parâmetro | Obrigatório | Predefinição | Descrição |
|---|
apikey |
Sim | Nenhum | A sua chave de API atribuída. Obter chave de API de teste gratuita. |
|---|
iata |
Condicional | Nenhum | Consulta uma companhia aérea pelo código IATA de dois caracteres, por exemplo UA. |
|---|
icao |
Condicional | Nenhum | Consulta uma companhia aérea pelo código ICAO de três letras, por exemplo UAL. |
|---|
name |
Condicional | Nenhum | Procura códigos de companhias aéreas pelo nome completo ou parcial. |
|---|
dump |
Condicional | 0 | Defina 1 para exportar o conjunto de dados completo, sujeito ao filtro onlyscheduled. |
|---|
response_type |
Não | JSON | Formato da resposta: JSON, XML ou CSV. CSV inicia a descarga de um ficheiro. |
|---|
onlyscheduled |
Não | 1 | Defina 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 →
Tarefas de implementação mais comuns
Descarregar e filtrar as classificações das companhias aéreas
Exporte com dump=1 e onlyscheduled=0 para incluir categorias para além das companhias regulares. Na sua aplicação, selecione lowcost igual a 1 para companhias low cost ou um type_code como 2 para charter de passageiros ou 8 para carga. Normalize as strings numéricas antes de comparar valores e mantenha a classificação low cost separada do tipo de companhia aérea.
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-metadata.csv
Encontrar os metadados de uma companhia aérea pelo nome
Pesquise com name, confirme a companhia pretendida e leia os campos de classificação. onlyscheduled=0 permite pesquisar para além das companhias regulares. A correspondência parcial por nome pode devolver vários registos; verifique as respetivas identidades antes de aplicar etiquetas.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=United' \
--data-urlencode 'onlyscheduled=0'
Obter classificações através de um código ICAO
Utilize icao quando a sua fonte fornecer um designador de companhia aérea com três letras. Este exemplo obtém a United Airlines com UAL. Inclua onlyscheduled=0 quando a consulta tiver de abranger outros tipos de operadores.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=UAL' \
--data-urlencode 'onlyscheduled=0'
Perguntas frequentes
O que devolve a API de metadados de companhias aéreas?
Esta página trata de lowcost, type e type_code na resposta da API de companhias aéreas. Identificam o indicador de companhia low cost, a etiqueta da categoria e o código de categoria correspondente, juntamente com os nomes e identificadores das companhias.
O que significam os valores de lowcost?
1 identifica uma companhia low cost. 0 significa que o registo da companhia não está assinalado como low cost. Trata-se de uma classificação da companhia, não de uma indicação sobre o preço ou o que inclui uma tarifa individual. Utilize os dados de tarifas do seu fornecedor de reservas para a bagagem incluída e os serviços incluídos.
Uma companhia aérea pode ser regular e low cost?
Sim. “Regular” é uma categoria de companhia aérea, enquanto lowcost é um indicador separado. Utilize ambos os campos quando a sua aplicação precisar de companhias regulares low cost. Selecione a categoria com type_code e a classificação low cost com lowcost.
Que tipos de companhias aéreas estão disponíveis?
Os códigos documentados são 1 Regular, 2 Charter de passageiros, 3 Comboio/autocarro/ferry, 4 Charter de helicópteros, 5 Charter de jatos, 6 Voos panorâmicos, 7 ACMI, 8 Carga e 9 Outros. Utilize type_code para filtros de categoria e type para a etiqueta fornecida.
Como obtenho operadores charter ou de carga?
Defina onlyscheduled=0 para incluir tipos para além das companhias regulares. Para um diretório, exporte com dump=1 e filtre localmente por type_code 2 para charter de passageiros ou 8 para carga. Os charters de helicópteros e de jatos têm códigos próprios, 4 e 5.
Posso enviar lowcost ou type_code como parâmetro de consulta?
São campos da resposta, não filtros de pedido documentados. Obtenha os registos de que precisa e filtre-os na sua aplicação. onlyscheduled é o parâmetro de pedido documentado para distinguir apenas companhias regulares de uma cobertura de tipos mais ampla. O valor predefinido de onlyscheduled é 1. Defina-o como 0 para uma cobertura mais ampla e selecione depois explicitamente as categorias de companhias, se o seu diretório deva excluir registos de comboio, autocarro e ferry.
onlyscheduled=1 significa que a companhia aérea está ativa?
Não. A categoria da companhia e o estado operacional são atributos distintos. Leia o campo status se precisar de distinguir companhias ativas, inativas e em fase de arranque.
Posso guardar os metadados das 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 em JSON, XML ou CSV e conserve airhex_id com as classificações. Atualize periodicamente os seus registos locais; a Airhex revê e atualiza diariamente os dados das companhias aéreas.
Como devo tratar indicadores numéricos e valores em falta?
Normalize as strings numéricas antes de comparar lowcost com 0 ou 1. Conserve os valores em falta ou inesperados como desconhecidos, em vez de os classificar silenciosamente.