API de companhias aéreas: base de dados de companhias aéreas e códigos

Transforme códigos de companhias aéreas em nomes reconhecíveis, marcas coerentes e informação útil para o passageiro. Consulte companhias aéreas individuais ou descarregue o diretório para alimentar os resultados de pesquisa, as reservas e os itinerários do seu produto de viagens.

Chave de API de testeVer exemplo
  • Consulta por código IATA e ICAO
  • JSON, XML e CSV
  • Registos individuais ou exportação completa

Consultar uma companhia aérea pelo código

Envie um código IATA, como WN, para obter a Southwest Airlines e os respetivos dados de referência. Substitua YOUR_API_KEY pela chave atribuída.

Descrição do endpoint

Este endpoint dá acesso a informação detalhada sobre companhias aéreas, com a possibilidade de obter registos individuais ou de exportar toda a base de dados de companhias aéreas em JSON, XML ou CSV.

Endpoint
GET https://content.airhex.com/api/v3.7.10/airlines/

Pedido · cURL

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

Resposta · JSON

[
    {
        "airhex_id": "1046",
        "updated": "2026-09-08 12:31:16",
        "iata": "WN",
        "icao": "SWA",
        "parent_icao": null,
        "marketing_name": "Southwest Airlines",
        "full_name": "Southwest Airlines Co.",
        "status": "1",
        "type": "SCHEDULED",
        "type_code": "1",
        "alliance": null,
        "ffp_name": "Rapid Rewards",
        "lowcost": "1",
        "country_name": "United States",
        "country_code_alpha_2": "US",
        "country_code_alpha_3": "USA",
        "founded": "1967",
        "baggage_url": "https:\/\/support.southwest.com\/helpcenter\/pathway\/baggage",
        "colorscheme": [
            {
                "color": [
                    220,
                    28,
                    36
                ],
                "percent": 46,
                "hex": "#DC1C24",
                "dark": 1
            },
            {
                "color": [
                    44,
                    66,
                    153
                ],
                "percent": 22,
                "hex": "#2C4299",
                "dark": 1
            },
            {
                "color": [
                    203,
                    203,
                    203
                ],
                "percent": 21,
                "hex": "#CBCBCB",
                "dark": 0
            },
            {
                "color": [
                    251,
                    172,
                    28
                ],
                "percent": 9,
                "hex": "#FBAC1C",
                "dark": 0
            },
            {
                "color": [
                    43,
                    60,
                    132
                ],
                "percent": 2,
                "hex": "#2B3C84",
                "dark": 1
            }
        ],
        "website": "https:\/\/www.southwest.com",
        "web_checkin_url": "https:\/\/www.southwest.com\/air\/check-in\/?clk=HP-CHKIN",
        "mobile_checkin_url": "https:\/\/mobile.southwest.com\/check-in",
        "logo_rectangle": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5",
        "logo_rectangle_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5"
    }
]

Resposta JSON completa. Desloque-se dentro do painel para ver todos os campos. Mais abaixo encontra exemplos expandidos em JSON e XML.

Parâmetros do pedido

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; o filtro onlyscheduled continua a aplicar-se.

Parâmetro Obrigatório Valor Tipo Predefinição Descrição
apikey Sim Qualquer String Nenhum A sua chave de API atribuída. Obter chave de API de teste gratuita.
iata Condicional 00-ZZ String Nenhum Código IATA da companhia aérea, com dois caracteres
icao Condicional 000-ZZZ String Nenhum Código ICAO da companhia aérea, com três letras
name Condicional Qualquer String Nenhum Nome da companhia aérea ou parte do nome para correspondência parcial
dump Condicional 0 ou 1 Integer 0 Defina 1 para exportar toda a base de dados. Prevalece sobre os outros parâmetros condicionais acima.
response_type Não JSON, XML ou CSV String JSON Formato da resposta: JSON, XML ou CSV (CSV inicia a descarga de um ficheiro)
onlyscheduled Não 0 ou 1 Integer 1 Filtro para incluir apenas companhias aéreas regulares (1) ou todos os tipos de companhias aéreas, incluindo carga, jatos privados, etc. (0)
logo_rectangle_width Não 1 a 1400 Integer 700 Largura das imagens de logótipo retangular
logo_rectangle_height Não 1 a 400 Integer 200 Altura das imagens de logótipo retangular
logo_square_width Não 1 a 400 Integer 200 Largura das imagens de logótipo quadrado e de cauda
logo_square_height Não 1 a 400 Integer 200 Altura das imagens de logótipo quadrado e de cauda

Campos da resposta

Obtenha no mesmo registo a identidade, os dados operacionais, as ligações de serviços ao passageiro e a marca de uma companhia aérea. Os campos com ligação abrem guias detalhados com exemplos específicos e conselhos de integração.

Campo Exemplo Descrição
airhex_id 1046 Identificador único e permanente do registo
updated 2026-09-08 12:31:16 Data e hora da última atualização do registo
iata WN Código IATA da companhia aérea
icao SWA Código ICAO da companhia aérea
parent_icao Código ICAO da companhia aérea-mãe (se aplicável)
marketing_name Southwest Airlines Nome da companhia aérea habitualmente usado para fins comerciais
full_name Southwest Airlines Co. Denominação social registada da companhia aérea
status 1 Estado operacional da companhia aérea: 1 = ativa, 0 = inativa, 2 = em fase de arranque (a iniciar operações)
type SCHEDULED Categoria da companhia aérea: regular, charter de passageiros, carga, ACMI, etc.
type_code 1 Código numérico do tipo de companhia aérea: 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, 9 = Outros
alliance Aliança a que a companhia aérea pertence (se aplicável)
ffp_name Rapid Rewards Nome do programa de passageiro frequente da companhia aérea
lowcost 1 Indica uma companhia low cost (1 se for low cost, 0 caso contrário)
country_name United States País da sede da companhia aérea
country_code_alpha_2 US Código de país ISO 3166-1 Alpha-2 da sede da companhia aérea
country_code_alpha_3 USA Código de país ISO 3166-1 Alpha-3 da sede da companhia aérea
founded 1967 Ano de fundação da companhia aérea
website https://www.southwest.com URL do site oficial da companhia aérea
web_checkin_url https://www.southwest.com/air/check-in/?clk=HP-CHKIN URL do check-in online para passageiros na web
mobile_checkin_url https://mobile.southwest.com/check-in URL do check-in para passageiros em dispositivos móveis
baggage_url https://support.southwest.com/helpcenter/pathway/baggage URL da política de bagagem incluída da companhia aérea
colorscheme [{"color":[220,28,36],"percent":46,"hex":"#DC1C24","dark":1},{"color":[44,66,153],"percent":22,"hex":"#2C4299","dark":1},{"color":[203,203,203],"percent":21,"hex":"#CBCBCB","dark":0},{"color":[251,172,28],"percent":9,"hex":"#FBAC1C","dark":0},{"color":[43,60,132],"percent":2,"hex":"#2B3C84","dark":1}] Array com as cores principais da marca da companhia aérea (valores RGB, percentagens, códigos hexadecimais e indicadores de tom escuro)
logo_rectangle https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32 URL direto do logótipo retangular da companhia aérea, com as dimensões indicadas e hash de API seguro
logo_square https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9 URL direto do logótipo quadrado da companhia aérea, com as dimensões indicadas e hash de API seguro
logo_tail https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27 URL direto do logótipo de cauda da companhia aérea, com as dimensões indicadas e hash de API seguro
logo_tail_flipped https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa URL direto do logótipo de cauda da companhia aérea, invertido horizontalmente, com as dimensões indicadas e hash de API seguro
logo_rectangle_dark https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32 URL direto do logótipo retangular da companhia aérea, otimizado para fundos escuros, com as dimensões indicadas e hash de API seguro
logo_square_dark https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9 URL direto do logótipo quadrado da companhia aérea, otimizado para fundos escuros, com as dimensões indicadas e hash de API seguro
logo_tail_dark https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27 URL direto do logótipo de cauda da companhia aérea, otimizado para fundos escuros, com as dimensões indicadas e hash de API seguro
logo_tail_flipped_dark https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa URL direto do logótipo de cauda da companhia aérea, invertido horizontalmente, otimizado para fundos escuros, com as dimensões indicadas e hash de API seguro
logo_rectangle_svg https://content.airhex.com/content/logos/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6 URL direto do logótipo retangular da companhia aérea, em formato vetorial SVG, com hash de API seguro
logo_square_svg https://content.airhex.com/content/logos/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c URL direto do logótipo quadrado da companhia aérea, em formato vetorial SVG, com hash de API seguro
logo_tail_svg https://content.airhex.com/content/logos/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4 URL direto do logótipo de cauda da companhia aérea, em formato vetorial SVG, com hash de API seguro
logo_tail_flipped_svg https://content.airhex.com/content/logos/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5 URL direto do logótipo de cauda da companhia aérea, invertido horizontalmente, em formato vetorial SVG, com hash de API seguro
logo_rectangle_svg_dark https://content.airhex.com/content/logos/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6 URL direto do logótipo retangular da companhia aérea, em formato vetorial SVG e otimizado para fundos escuros, com hash de API seguro
logo_square_svg_dark https://content.airhex.com/content/logos/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c URL direto do logótipo quadrado da companhia aérea, em formato vetorial SVG e otimizado para fundos escuros, com hash de API seguro
logo_tail_svg_dark https://content.airhex.com/content/logos/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4 URL direto do logótipo de cauda da companhia aérea, em formato vetorial SVG e otimizado para fundos escuros, com hash de API seguro
logo_tail_flipped_svg_dark https://content.airhex.com/content/logos/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5 URL direto do logótipo de cauda da companhia aérea, invertido horizontalmente, em formato vetorial SVG e otimizado para fundos escuros, com hash de API seguro

Exemplos de resposta completos

Estes exemplos mostram o registo completo da Southwest Airlines em JSON e XML. Utilize response_type para escolher o formato de saída.

Resposta · JSON

[
    {
        "airhex_id": "1046",
        "updated": "2026-09-08 12:31:16",
        "iata": "WN",
        "icao": "SWA",
        "parent_icao": null,
        "marketing_name": "Southwest Airlines",
        "full_name": "Southwest Airlines Co.",
        "status": "1",
        "type": "SCHEDULED",
        "type_code": "1",
        "alliance": null,
        "ffp_name": "Rapid Rewards",
        "lowcost": "1",
        "country_name": "United States",
        "country_code_alpha_2": "US",
        "country_code_alpha_3": "USA",
        "founded": "1967",
        "baggage_url": "https:\/\/support.southwest.com\/helpcenter\/pathway\/baggage",
        "colorscheme": [
            {
                "color": [
                    220,
                    28,
                    36
                ],
                "percent": 46,
                "hex": "#DC1C24",
                "dark": 1
            },
            {
                "color": [
                    44,
                    66,
                    153
                ],
                "percent": 22,
                "hex": "#2C4299",
                "dark": 1
            },
            {
                "color": [
                    203,
                    203,
                    203
                ],
                "percent": 21,
                "hex": "#CBCBCB",
                "dark": 0
            },
            {
                "color": [
                    251,
                    172,
                    28
                ],
                "percent": 9,
                "hex": "#FBAC1C",
                "dark": 0
            },
            {
                "color": [
                    43,
                    60,
                    132
                ],
                "percent": 2,
                "hex": "#2B3C84",
                "dark": 1
            }
        ],
        "website": "https:\/\/www.southwest.com",
        "web_checkin_url": "https:\/\/www.southwest.com\/air\/check-in\/?clk=HP-CHKIN",
        "mobile_checkin_url": "https:\/\/mobile.southwest.com\/check-in",
        "logo_rectangle": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5",
        "logo_rectangle_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5"
    }
]

Resposta · XML

<?xml version="1.0" encoding="UTF-8"?>
<airlines>
 <airline>
  <airhex_id>1046</airhex_id>
  <updated>2026-09-08 12:31:16</updated>
  <iata>WN</iata>
  <icao>SWA</icao>
  <parent_icao></parent_icao>
  <marketing_name>Southwest Airlines</marketing_name>
  <full_name>Southwest Airlines Co.</full_name>
  <status>1</status>
  <type>SCHEDULED</type>
  <type_code>1</type_code>
  <alliance></alliance>
  <ffp_name>Rapid Rewards</ffp_name>
  <lowcost>1</lowcost>
  <country_name>United States</country_name>
  <country_code_alpha_2>US</country_code_alpha_2>
  <country_code_alpha_3>USA</country_code_alpha_3>
  <founded>1967</founded>
  <baggage_url>https://support.southwest.com/helpcenter/pathway/baggage</baggage_url>
  <website>https://www.southwest.com</website>
  <web_checkin_url>https://www.southwest.com/air/check-in/?clk=HP-CHKIN</web_checkin_url>
  <mobile_checkin_url>https://mobile.southwest.com/check-in</mobile_checkin_url>
  <logo_rectangle>https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32</logo_rectangle>
  <logo_square>https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9</logo_square>
  <logo_tail>https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27</logo_tail>
  <logo_tail_flipped>https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa</logo_tail_flipped>
  <logo_rectangle_dark>https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32</logo_rectangle_dark>
  <logo_square_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9</logo_square_dark>
  <logo_tail_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27</logo_tail_dark>
  <logo_tail_flipped_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa</logo_tail_flipped_dark>
  <logo_rectangle_svg>https://content.airhex.com/content/logos/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6</logo_rectangle_svg>
  <logo_square_svg>https://content.airhex.com/content/logos/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c</logo_square_svg>
  <logo_tail_svg>https://content.airhex.com/content/logos/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4</logo_tail_svg>
  <logo_tail_flipped_svg>https://content.airhex.com/content/logos/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5</logo_tail_flipped_svg>
  <logo_rectangle_svg_dark>https://content.airhex.com/content/logos/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6</logo_rectangle_svg_dark>
  <logo_square_svg_dark>https://content.airhex.com/content/logos/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c</logo_square_svg_dark>
  <logo_tail_svg_dark>https://content.airhex.com/content/logos/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4</logo_tail_svg_dark>
  <logo_tail_flipped_svg_dark>https://content.airhex.com/content/logos/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5</logo_tail_flipped_svg_dark>
 </airline>
</airlines>

Tarefas de implementação mais comuns

Descarregar o diretório de companhias aéreas

Exporte o diretório em CSV para a sua própria base de dados. Defina onlyscheduled=0 para incluir todos os tipos de companhias aéreas e conserve airhex_id e updated ao importar os registos.

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

Resolver um identificador ICAO de companhia aérea

Utilize icao quando a sua fonte de dados fornecer um código ICAO de companhia aérea com três letras. Leia o código IATA e o nome da companhia aérea devolvidos para ligar registos entre as suas ferramentas.

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

Pesquisar pelo nome da companhia aérea

As pesquisas por nome admitem correspondências parciais. Compare as identidades e os códigos devolvidos antes de escolher um registo.

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

O que pode criar

Mostrar nomes de companhias aéreas que os viajantes reconhecem

Apresente nomes comerciais familiares, em vez de denominações sociais, nos resultados de voos, nas reservas e na informação ao passageiro.

Facilitar a preparação da viagem

Inclua ligações oficiais de check-in e de política de bagagem diretamente nas confirmações e nos itinerários.

Manter o diretório de companhias aéreas atualizado

Mantenha coerentes a identidade, o estado e a classificação das companhias aéreas em todas as suas ferramentas de viagens, com dados de referência atualizados regularmente.

Perguntas frequentes

A API fornece nomes de companhias aéreas reconhecíveis ou denominações sociais?

Ambos. Utilize marketing_name para o nome familiar que os viajantes reconhecem, como Lufthansa, e full_name para a denominação social registada. A Airhex mantém estes nomes, pelo que a sua equipa não precisa de converter manualmente as denominações sociais dos diretórios em nomes de apresentação.

Como mantenho os meus registos de companhias aéreas atualizados?

A Airhex revê e atualiza diariamente os dados das companhias aéreas. Atualize periodicamente o seu diretório local. A API de alterações disponibiliza um registo de alterações recentes; utilize-o para acompanhar as mudanças e obter os registos atuais a partir da API de companhias aéreas.

Posso guardar o diretório na minha própria base de dados?

Sim, com uma licença adequada da base de dados de companhias aéreas. Utilize dump=1 e escolha JSON, XML ou CSV. Conserve airhex_id como identificador permanente do registo, guarde updated e planeie atualizações periódicas da sua cópia local.

Que companhias aéreas são devolvidas por predefinição?

O filtro predefinido onlyscheduled=1 seleciona as companhias aéreas regulares. Defina onlyscheduled=0 para incluir todos os tipos de companhias aéreas e, depois, verifique status e type_code ao aplicar as suas próprias regras. O estado descreve a companhia aérea: 1 = ativa, 0 = inativa, 2 = em fase de arranque.

Posso fazer corresponder companhias aéreas comercializadoras e operadoras de um fornecedor de reservas?

Sim. Consulte cada código de companhia fornecido em separado, com iata ou icao, consoante o sistema de códigos do fornecedor. O seu fornecedor de voos determina as companhias comercializadora e operadora de um voo; esta API fornece os dados de referência dessas companhias aéreas.

Todas as companhias aéreas têm todos os campos da resposta?

Não parta do princípio de que todos os registos têm ambos os códigos de companhia aérea, uma aliança, um programa de passageiro frequente ou todas as ligações de serviços ao passageiro. Verifique se os valores estão preenchidos antes de criar correspondências ou de apresentar ligações e conserve o identificador original do fornecedor como alternativa quando uma consulta não puder ser resolvida.

Como posso acrescentar informações de check-in e de bagagem aos meus itinerários?

Utilize web_checkin_url e baggage_url para encaminhar os viajantes para os serviços oficiais da companhia aérea a partir de confirmações, bilhetes eletrónicos ou ecrãs de itinerário. Verifique se cada URL está preenchido antes de o apresentar. A API fornece ligações; não faz o check-in de passageiros nem calcula a bagagem incluída e as taxas específicas de um bilhete.

Posso filtrar os pedidos por aliança, por companhia low cost ou por estado da companhia aérea?

Esses valores são campos da resposta, não filtros do pedido neste endpoint. Obtenha os registos pretendidos ou exporte o diretório e aplique depois esses filtros na sua aplicação. Os parâmetros de pedido disponíveis estão indicados acima.

Inclui tarifas, disponibilidade ou o estado dos voos em tempo real?

Não. Este endpoint fornece dados de referência de companhias aéreas. Recorra ao seu fornecedor de voos para tarifas, disponibilidade, horários e estado de cada voo. O estado operacional da companhia aérea não descreve o estado de um voo em particular.

Está a planear o seu processo de atualização? Consulte a referência da API de alterações →

Integre informação atualizada de companhias aéreas no seu produto de viagens

Apresente nomes de companhias aéreas reconhecíveis e ligações úteis de serviços ao passageiro na pesquisa, na reserva e no itinerário, enquanto a Airhex mantém o diretório subjacente.

Chave de API de testePedir orçamento →