API colori del brand delle compagnie aeree

Porta nella tua esperienza di viaggio gli accenti di colore delle compagnie aeree. Recupera i dati sui colori del brand associati a nomi e codici delle compagnie, con valori esadecimali e RGB pronti da usare in schede dei voli, itinerari e profili delle compagnie aeree.

Chiave API di prova Vedi l’esempio
  • Valori di colore esadecimali e RGB
  • Ricerca per codice o nome
  • Metadati della tavolozza

Recupera i colori del brand di una compagnia aerea

Cerca United Airlines con il suo codice IATA UA e leggi l’array colorscheme. Ogni voce della tavolozza include valori RGB, un valore esadecimale, una percentuale e un indicatore di tonalità scura. Sostituisci YOUR_API_KEY con la tua chiave API.

Richiesta · cURL

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

Risposta · estratto JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "colorscheme": [
      {
        "color": [20, 20, 212],
        "percent": 98,
        "hex": "#1414D4",
        "dark": 1
      }
    ],
    ...
  }
]

Risposta abbreviata. I puntini di sospensione (…) rappresentano altri campi della compagnia aerea omessi qui e non fanno parte della risposta JSON effettiva.

Vedi il riferimento completo: API compagnie aeree →

Parametri della richiesta

Cerca una compagnia aerea o esporta l’elenco, poi leggi colorscheme dai record restituiti. colorscheme è un campo della risposta, non un parametro di richiesta. Usa JSON per lavorare direttamente con le voci annidate della tavolozza.

ParametroObbligatorioPredefinitoDescrizione
apikey SìNessunoLa tua chiave API. Richiedi una chiave API di prova gratuita.
iata CondizionaleNessunoCerca una compagnia aerea tramite il suo codice IATA a due caratteri, ad esempio UA.
icao CondizionaleNessunoCerca una compagnia aerea tramite il suo codice ICAO a tre lettere, ad esempio UAL.
name CondizionaleNessunoTrova i codici delle compagnie aeree tramite il nome, anche parziale.
dump Condizionale0Imposta 1 per esportare l’intero set di dati, con il filtro onlyscheduled ancora attivo.
response_type NoJSONFormato della risposta: JSON, XML o CSV. Con CSV parte il download di un file.
onlyscheduled No1Imposta 1 per le sole compagnie aeree di linea, oppure 0 per tutti i tipi di compagnia.

Indica almeno uno tra iata, icao, name o dump=1. Con dump=1 gli altri parametri di ricerca vengono ignorati.

Vedi tutti i parametri della richiesta →

Dati disponibili

Usa colorscheme insieme all’identità della compagnia aerea per scegliere gli accenti di colore. Le righe seguenti descrivono l’array della tavolozza e le sue proprietà annidate: conserva l’intero array quando salvi la risposta.

CampoTipoEsempioDescrizione
airhex_id String965Identificatore permanente del record Airhex. Usalo per associare gli aggiornamenti futuri allo stesso record.
iata StringUACodice IATA della compagnia aerea a due caratteri. I codici possono contenere lettere e cifre: memorizzali come testo.
icao StringUALCodice ICAO della compagnia aerea a tre lettere, utile per passare da un sistema di codici all’altro.
marketing_name StringUnited AirlinesNome della compagnia aerea comunemente usato per la visualizzazione nella tua applicazione.
colorscheme ArrayVedi l’esempio JSONVoci dei colori del brand della compagnia aerea, con RGB, percentuale, valore esadecimale e metadati di tonalità scura.
colorscheme[].color Array[20, 20, 212]Componenti RGB di questa voce della tavolozza, in ordine rosso, verde, blu.
colorscheme[].percent Number98Percentuale fornita per questa voce della tavolozza; non è una proporzione consigliata per il layout dell’interfaccia.
colorscheme[].hex String#1414D4Valore di colore esadecimale di questa voce della tavolozza.
colorscheme[].dark Integer1Indicatore di tonalità scura fornito con questa voce; non è un rapporto di contrasto del testo misurato.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica le tavolozze delle compagnie aeree per la tua applicazione

Esporta l’elenco in JSON per conservare ogni array colorscheme e le sue proprietà annidate. Salva le tavolozze insieme a nomi, codici e airhex_id delle compagnie. Imposta onlyscheduled=0 se ti servono tipi di vettore oltre alle compagnie di linea, poi seleziona i record rilevanti nella tua applicazione.

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

Trova i colori del brand dal nome della compagnia aerea

Cerca con name, conferma la compagnia aerea giusta e leggi colorscheme. Le ricerche per nome supportano la corrispondenza parziale, quindi controlla l’identità restituita prima di applicare una tavolozza alla scheda o al profilo di una compagnia.

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

Recupera una tavolozza con un codice ICAO

Usa icao quando la tua fonte dati fornisce un identificativo di compagnia aerea a tre lettere. Questo esempio recupera United Airlines con UAL e restituisce il suo colorscheme insieme all’identità della compagnia.

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

Cosa puoi creare

Accenti delle compagnie aeree nei risultati dei voli

Applica i colori delle compagnie aeree a bordi delle schede, badge o altri accenti, mantenendo leggibili prezzi e informazioni sul volo.

Profili delle compagnie aeree coerenti

Usa la stessa tavolozza salvata nei profili delle compagnie, nelle viste degli itinerari e nelle pagine di confronto tra vettori.

Dashboard di report riconoscibili

Associa i colori dei vettori a serie e legende dei grafici, accanto a etichette di testo che identificano ogni compagnia aerea.

Domande frequenti

Che cosa restituisce l’API colori del brand delle compagnie aeree?

Il campo colorscheme contiene un array di voci della tavolozza. Ogni voce include color per i componenti RGB, hex per il valore esadecimale, percent per la percentuale fornita e dark per un indicatore di tonalità scura.

Posso usare i valori esadecimali restituiti in CSS?

Sì. Un valore esadecimale restituito, come #1414D4, si può usare come colore CSS. Verifica che la tavolozza e il valore esistano prima di applicarli e mantieni un colore predefinito per i dati mancanti. Usa color per i componenti RGB. Mantieni visibili nome e logo della compagnia aerea, così i viaggiatori possono riconoscere il vettore senza affidarsi al solo colore.

L’API fornisce un solo colore principale o più colori?

La risposta usa un array, quindi la tua integrazione deve gestire più voci invece di presumere un unico colore. Scegli quale voce mostrare in base alle esigenze della tua interfaccia; non dare per scontato che ogni compagnia aerea abbia una tavolozza della stessa dimensione.

percent deve determinare quanta parte della mia interfaccia usa un colore?

No. È un metadato fornito con la voce della tavolozza, non un’indicazione per il layout della pagina. Spetta al tuo design system stabilire dove e in quale misura usare ciascun colore.

dark garantisce un testo bianco o nero leggibile?

No. Considera dark un indicatore di tonalità scura, non una certificazione di accessibilità né un rapporto di contrasto. Verifica la specifica combinazione di primo piano e sfondo nella tua interfaccia.

La tavolozza sostituisce le linee guida del brand di una compagnia aerea?

No. Il campo fornisce dati sui colori, non un manuale del brand completo, una specifica dei colori per la stampa né l’autorizzazione a usare i marchi di una compagnia aerea. Per le applicazioni che richiedono specifiche esatte del brand usa le indicazioni ufficiali del brand.

Che cosa devo fare se colorscheme manca o è vuoto?

Usa lo stile predefinito della tua applicazione e mantieni visibile il nome della compagnia aerea. Non dedurre una tavolozza dall’alleanza o dal vettore capogruppo della compagnia.

Posso scaricare e salvare in locale i colori delle compagnie aeree?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta con dump=1 e response_type=JSON per conservare la struttura annidata della tavolozza. Mantieni l’identità della compagnia aerea con ogni tavolozza e aggiorna periodicamente i record salvati. Conserva airhex_id e il timestamp updated della risposta completa per rilevare le modifiche alla tavolozza.

Rendi le compagnie aeree più riconoscibili nel tuo prodotto

Porta accenti di colore coerenti delle compagnie aeree in risultati dei voli, profili e informazioni per i passeggeri, senza dover cercare a mano la tavolozza di ogni vettore.

Chiave API di provaRichiedi un preventivo →

API compagnie aeree →

Scopri l’intero set di dati delle compagnie aeree: codici IATA e ICAO, nomi, stato operativo, tipi di compagnia, alleanze, programmi fedeltà, link al check-in online e alle regole sui bagagli, loghi e colori del brand. Consulta tutti i parametri della richiesta e i campi della risposta, con ricerche singole ed esportazioni complete in JSON, XML e CSV.

API alleanze aeree →

Cerca l’alleanza di una compagnia aerea per codice IATA, ICAO o nome. Crea filtri per alleanza e raggruppa le compagnie aeree nella tua app di viaggio con Airhex.

API metadati delle compagnie aeree →

Recupera il flag low cost e il tipo delle compagnie aeree (di linea, charter, cargo, ACMI). Cerca i metadati delle compagnie aeree per codice o nome con Airhex.

API stato delle compagnie aeree →

Cerca lo stato operativo di una compagnia aerea (attiva, non attiva o in fase di avvio) per codice o nome e filtra il tuo elenco locale con Airhex.