API de política de bagagem de companhias aéreas

Ajude os viajantes a encontrar a política de bagagem da sua companhia aérea diretamente no processo de reserva ou no itinerário. Obtenha os URLs oficiais da política associados a códigos e nomes de companhias aéreas, ou descarregue o diretório para a sua própria aplicação.

Chave de API de teste Ver exemplo
  • Ligações oficiais para a política de bagagem
  • Consulta por código ou nome
  • JSON, XML e CSV

Obter a ligação para a política de bagagem de uma companhia aérea

Consulte a Southwest Airlines com o código IATA WN e leia baggage_url. Utilize o URL devolvido para criar uma ligação para a política de bagagem na sua aplicação. 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",
    "baggage_url": "https://support.southwest.com/helpcenter/pathway/baggage",
    ...
  }
]

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 a API de companhias aéreas para obter uma companhia individual ou exportar o diretório. baggage_url é um campo da resposta; não é necessário um endpoint separado de política de bagagem nem um parâmetro de consulta baggage_url.

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

Associe baggage_url à identidade da companhia aérea antes de o apresentar. A API fornece uma ligação para a página da política da companhia; não devolve bagagem incluída, dimensões nem taxas estruturadas para um bilhete específico.

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.
baggage_url String (URL)https://support.southwest.com/helpcenter/pathway/baggageURL da política de bagagem incluída da companhia aérea.

Ver todos os dados disponíveis →

Tarefas de implementação mais comuns

Descarregar as ligações da política de bagagem do seu diretório de companhias aéreas

Exporte o diretório de companhias aéreas em CSV e conserve baggage_url juntamente com os nomes, os códigos e airhex_id. Apresente uma ligação para a política apenas quando existir um URL. Utilize onlyscheduled=0 se precisar também de tipos de companhias para além das regulares e selecione os registos relevantes na sua aplicação.

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-baggage-links.csv

Encontrar uma política de bagagem pelo nome da companhia aérea

Pesquise com name, selecione a companhia pretendida e leia baggage_url. A correspondência parcial por nome pode devolver vários registos; confirme a identidade antes de apresentar a ligação para a política.

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

Obter uma ligação para a política através de um código ICAO

Utilize icao se a sua fonte identificar a companhia aérea com um designador ICAO de três letras. Este exemplo obtém a Southwest Airlines com SWA e devolve o mesmo registo da companhia e o mesmo campo de política de bagagem.

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

O que pode criar

Orientações sobre bagagem durante a reserva

Dê aos viajantes acesso à política da companhia aérea enquanto reveem o itinerário e a bagagem incluída no seu bilhete.

Comunicações úteis antes da viagem

Inclua uma ligação claramente identificada para a política de bagagem da companhia aérea nas confirmações de reserva e nas mensagens anteriores à partida.

Apoio ao cliente mais rápido

Permita que os agentes encontrem a ligação para a política da companhia aérea de uma reserva sem manter uma lista separada de URLs.

Perguntas frequentes

O que devolve a API de política de bagagem de companhias aéreas?

O campo baggage_url contém um URL da política de bagagem incluída da companhia aérea. É devolvido no registo da API de companhias aéreas, juntamente com o nome da companhia, os códigos e outros dados de referência.

A API devolve pesos, dimensões ou taxas de bagagem?

Este campo devolve um URL da política, não dados estruturados sobre bagagem incluída ou preços. Os viajantes podem seguir a ligação para a política da companhia aérea. Obtenha a bagagem a que cada bilhete dá direito e as opções adquiríveis junto do seu fornecedor de reservas.

Posso usar a ligação da política para determinar o que uma tarifa inclui?

Não. Uma ligação geral para a política da companhia aérea não determina a bagagem a que uma reserva individual dá direito. Utilize a bagagem incluída fornecida com a tarifa ou o bilhete selecionado e ofereça a ligação para a política como orientação adicional.

Posso obter uma política por código IATA, código ICAO ou nome?

Sim. Utilize iata, icao ou name para obter o registo de uma companhia aérea e leia depois baggage_url. As pesquisas por nome admitem correspondências parciais; verifique a companhia devolvida antes de usar a respetiva ligação.

Que ligação devo mostrar num itinerário com codeshare ou várias companhias aéreas?

Associe cada ligação para a política ao registo da companhia a que pertence e identifique-a com o nome dessa companhia. Não use este campo isoladamente para decidir que regras de companhia se aplicam ao bilhete; utilize a informação de bagagem fornecida com a reserva. Utilize uma etiqueta clara, como “Ver a política de bagagem da companhia aérea”, para que os viajantes saibam o que vão abrir.

O que devo fazer quando baggage_url está vazio?

Não apresente uma ligação vazia ou quebrada. Omita o botão da política ou ofereça outro caminho de apoio na sua aplicação. A falta de dados não significa que a companhia aérea permita ou proíba determinada bagagem, nem que não tenha uma política de bagagem.

Posso guardar as ligações da política de bagagem 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 a identidade da companhia aérea com cada URL. Atualize periodicamente os registos guardados; a Airhex revê e atualiza diariamente os dados das companhias aéreas. Conserve airhex_id e a data e hora updated da resposta completa, para que as importações captem as alterações dos URLs das políticas.

A API fornece o texto da política ou versões traduzidas?

O campo baggage_url documentado fornece um URL, não o texto da política nem variantes por idioma. A página da companhia aérea de destino controla o conteúdo e as opções de idioma disponíveis para o viajante.

Ajude os viajantes a encontrar a política de bagagem da sua companhia aérea

Coloque as ligações para as políticas das companhias aéreas onde os viajantes precisam delas — nos processos de reserva, nos itinerários e nas ferramentas de apoio — sem manter um diretório de URLs separado.

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.