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 tabela de consulta de códigos, conserve apenas os registos com código IATA.
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 IATA a partir do nome de uma companhia aérea
Pesquise com name e leia iata 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 ICAO a um código IATA
Envie o designador ICAO em icao e leia o campo iata devolvido. Isto ajuda a conciliar identificadores de companhias aéreas de diferentes fontes de dados.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=SWA'
Perguntas frequentes
Qual é a diferença entre códigos IATA de companhias aéreas, códigos de aeroportos e códigos ICAO?
Um código IATA de companhia aérea é um designador de dois caracteres, como WN para a Southwest Airlines, e pode incluir dígitos. Os códigos IATA de aeroportos identificam locais e têm três letras. Os códigos ICAO de companhias aéreas são um sistema distinto de três letras; o código ICAO da Southwest é SWA.
Posso fazer corresponder as companhias aéreas do meu fornecedor de reservas de voos?
Se o seu fornecedor devolver um código IATA de companhia aérea, envie-o no parâmetro iata para obter o nome da companhia e os dados de referência associados. Se o fornecedor devolver códigos ICAO, utilize icao. Confirme o sistema de códigos de cada campo do fornecedor antes de fazer a correspondência.
Como devo tratar as companhias comercializadora e operadora?
Utilize os identificadores das companhias comercializadora e operadora fornecidos com o voo e consulte cada companhia em separado. Pode depois apresentar a companhia comercializadora e, quando adequado, uma indicação “operado por”. Este endpoint de referência não determina que companhia opera um voo em particular.
Todos os registos de companhias aéreas têm código IATA?
Não parta do princípio de que todos os registos têm código IATA. Verifique se o campo iata está preenchido antes de acrescentar um registo à sua tabela de consulta IATA. Conserve airhex_id como identificador permanente do registo no seu diretório local, em vez de usar o código da companhia aérea como chave permanente.
Como deve a minha integração tratar correspondências em falta ou ambíguas?
Trate os pedidos sem êxito em separado das consultas que não encontram nenhuma companhia aérea correspondente. Conserve o código original do fornecedor como alternativa de apresentação quando não o conseguir resolver. As pesquisas por nome admitem correspondências parciais; compare as identidades e os códigos devolvidos em vez de escolher automaticamente o primeiro registo.
Posso descarregar o diretório e guardá-lo na minha própria base de dados?
Sim, com uma licença adequada da base de dados de companhias aéreas. Utilize dump=1 para exportar o diretório em JSON, XML ou CSV e defina onlyscheduled=0 se precisar de todos os tipos de companhias aéreas. Com uma cópia local, a sua aplicação resolve os nomes das companhias aéreas sem fazer um pedido à API para cada resultado de voo. Confirme os direitos de utilização da sua integração ao pedir o acesso.
Como mantenho os códigos das companhias aéreas atualizados?
A Airhex revê e atualiza diariamente os dados das companhias aéreas. Atualize periodicamente o seu diretório local e conserve airhex_id e updated ao importar os registos. A API de alterações disponibiliza um registo de alterações recentes; utilize-a para acompanhar as mudanças e obter os registos atuais a partir da API de companhias aéreas. Consulte a referência completa da API de companhias aéreas e a documentação da API de alterações ao planear o processo de atualização.
Inclui disponibilidade de voos, tarifas ou estado dos voos?
Não. Este endpoint fornece dados de referência para identificar e apresentar companhias aéreas. Obtenha a disponibilidade, as tarifas e o estado de cada voo junto do seu fornecedor de voos. O campo status descreve aqui o estado operacional da companhia aérea, não o estado de um voo.
Como escolho os tipos de companhias aéreas a incluir?
O filtro predefinido onlyscheduled=1 seleciona as companhias aéreas regulares. Utilize onlyscheduled=0 para todos os tipos de companhias aéreas e verifique status quando a sua aplicação só deva mostrar companhias ativas.