API de cores da marca de companhias aéreas

Leve as cores das companhias aéreas para a sua experiência de viagem. Obtenha dados das cores da marca associados a nomes e códigos de companhias aéreas, com valores hexadecimais e RGB prontos a usar em cartões de voo, itinerários e perfis de companhias aéreas.

Chave de API de teste Ver exemplo
  • Valores de cor hexadecimais e RGB
  • Consulta por código ou nome
  • Metadados da paleta

Obter as cores da marca de uma companhia aérea

Consulte a United Airlines com o código IATA UA e leia o array colorscheme. Cada entrada da paleta inclui valores RGB, um valor hexadecimal, uma percentagem e um indicador de tom escuro. 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=UA'

Resposta · excerto JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "colorscheme": [
      {
        "color": [20, 20, 212],
        "percent": 98,
        "hex": "#1414D4",
        "dark": 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 exporte o diretório e leia colorscheme nos registos devolvidos. colorscheme é um campo da resposta e não um parâmetro do pedido. Utilize JSON para trabalhar diretamente com as entradas aninhadas da paleta.

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 UA.
icao CondicionalNenhumConsulta uma companhia aérea pelo código ICAO de três letras, por exemplo UAL.
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

Utilize colorscheme com a identidade da companhia aérea para escolher as cores de destaque. As linhas abaixo descrevem o array da paleta e as suas propriedades aninhadas; conserve o array completo ao guardar a resposta.

CampoTipoExemploDescrição
airhex_id String965Identificador permanente do registo na Airhex. Utilize-o para associar atualizações futuras ao mesmo registo.
iata StringUADesignador IATA da companhia aérea, com dois caracteres. Os códigos podem conter letras e dígitos; guarde-os como texto.
icao StringUALDesignador ICAO da companhia aérea, com três letras, útil para fazer corresponder sistemas de códigos.
marketing_name StringUnited AirlinesNome da companhia aérea habitualmente usado, para apresentação na sua aplicação.
colorscheme ArrayVer exemplo JSONEntradas de cores da marca da companhia aérea, com RGB, percentagem, valor hexadecimal e metadados de tom escuro.
colorscheme[].color Array[20, 20, 212]Componentes RGB desta entrada da paleta, pela ordem vermelho, verde, azul.
colorscheme[].percent Número98Percentagem fornecida para esta entrada da paleta; não é uma proporção recomendada para a disposição da interface.
colorscheme[].hex String#1414D4Valor hexadecimal da cor desta entrada da paleta.
colorscheme[].dark Integer1Indicador de tom escuro fornecido com esta entrada; não é uma razão de contraste de texto medida.

Ver todos os dados disponíveis →

Tarefas de implementação mais comuns

Descarregar as paletas das companhias aéreas para a sua aplicação

Exporte o diretório em JSON para conservar cada array colorscheme e as suas propriedades aninhadas. Guarde as paletas com os nomes das companhias, os códigos e airhex_id. Defina onlyscheduled=0 se precisar de tipos de companhias para além das regulares e selecione depois 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=JSON' \
  --output airline-brand-colors.json

Encontrar as cores da marca pelo nome da companhia aérea

Pesquise com name, confirme a companhia pretendida e leia colorscheme. As pesquisas por nome admitem correspondências parciais; verifique a identidade devolvida antes de aplicar uma paleta a um cartão ou perfil de companhia aérea.

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

Obter uma paleta através de um código ICAO

Utilize icao quando a sua fonte de dados fornecer um identificador de companhia aérea com três letras. Este exemplo obtém a United Airlines com UAL e devolve o respetivo colorscheme juntamente com a identidade da companhia.

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

O que pode criar

Cores das companhias nos resultados de voos

Aplique as cores das companhias aéreas a contornos de cartões, emblemas ou outros destaques, mantendo legíveis os preços e a informação do voo.

Perfis de companhias aéreas consistentes

Utilize a mesma paleta guardada em perfis de companhias aéreas, vistas de itinerário e páginas de comparação de companhias.

Painéis de relatórios reconhecíveis

Associe as cores das companhias a séries e legendas de gráficos, juntamente com etiquetas de texto que identifiquem cada companhia aérea.

Perguntas frequentes

O que devolve a API de cores da marca das companhias aéreas?

O campo colorscheme contém um array de entradas de paleta. Cada entrada inclui color para os componentes RGB, hex para o valor hexadecimal, percent para a percentagem fornecida e dark para um indicador de tom escuro.

Posso usar os valores hexadecimais devolvidos em CSS?

Sim. Um valor hexadecimal devolvido, como #1414D4, pode ser usado como cor em CSS. Verifique se a paleta e o valor existem antes de os aplicar e conserve uma cor predefinida para dados em falta. Utilize color para os componentes RGB. Mantenha visíveis o nome e o logótipo da companhia aérea, para que os viajantes a identifiquem sem depender apenas da cor.

A API fornece uma cor principal ou várias cores?

A resposta usa um array, pelo que a sua integração deve aceitar várias entradas em vez de assumir uma única cor. Escolha a entrada a apresentar de acordo com os requisitos da sua interface; não parta do princípio de que todas as companhias aéreas têm uma paleta do mesmo tamanho.

O valor percent deve determinar quanto da minha interface usa uma cor?

Não. É um metadado fornecido com a entrada da paleta, não uma instrução de disposição da página. O seu sistema de design deve determinar onde e em que medida usar cada cor.

O valor dark garante texto branco ou preto legível?

Não. Trate dark como um indicador de tom escuro, não como uma certificação de acessibilidade nem como uma razão de contraste. Verifique a combinação concreta de primeiro plano e fundo na sua interface.

A paleta substitui as diretrizes de marca de uma companhia aérea?

Não. O campo fornece dados de cor, não um manual de marca completo, uma especificação de cor para impressão nem autorização para usar as marcas de uma companhia aérea. Utilize as diretrizes de marca adequadas em aplicações que exijam especificações de marca exatas.

O que devo fazer se colorscheme estiver em falta ou vazio?

Utilize o estilo predefinido da sua aplicação e mantenha visível o nome da companhia aérea. Não deduza uma paleta a partir da aliança ou da companhia aérea-mãe.

Posso descarregar e guardar localmente as cores das companhias aéreas?

Sim, com uma licença adequada da base de dados de companhias aéreas. Exporte com dump=1 e response_type=JSON para conservar a estrutura aninhada da paleta. Conserve a identidade da companhia aérea com cada paleta e atualize periodicamente os registos guardados. Conserve airhex_id e a data e hora updated da resposta completa para captar alterações da paleta.

Torne as companhias aéreas mais reconhecíveis no seu produto

Leve cores de companhias aéreas consistentes para os resultados de voos, os perfis e a informação ao passageiro, sem pesquisar manualmente a paleta de cada companhia.

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.