API codici ICAO delle compagnie aeree

Identifica le compagnie aeree dai codici ICAO a tre lettere presenti nei tuoi dati aeronautici. Recupera nomi e codici IATA corrispondenti, oppure scarica l’elenco per associare i record nella tua applicazione.

Chiave API di prova Vedi l’esempio
  • Ricerca per codice o nome
  • JSON, XML e CSV
  • Singoli record o esportazione completa

Cerca una compagnia aerea tramite codice ICAO

Invia il codice a tre lettere di una compagnia aerea nel parametro icao dell’API compagnie aeree. Questo esempio cerca Southwest Airlines con SWA. 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 'icao=SWA'

Risposta · estratto JSON

[
  {
    "iata": "WN",
    "icao": "SWA",
    "marketing_name": "Southwest Airlines",
    ...
  }
]

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

Usa questi parametri di query per cercare i codici delle compagnie aeree o esportare l’elenco.

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 WN.
icao CondizionaleNessunoCerca una compagnia aerea tramite il suo codice ICAO a tre lettere, ad esempio SWA.
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 icao per identificare una compagnia aerea e iata per associarla ai dati del sistema di prenotazione quando è disponibile un codice IATA. I campi selezionati qui sotto seguono l’ordine del riferimento dell’API principale.

CampoTipoEsempioDescrizione
airhex_id Identificatore1046Identificatore permanente del record Airhex. Usalo per associare gli aggiornamenti futuri allo stesso record.
iata StringWNCodice IATA della compagnia aerea a due caratteri. I codici possono contenere lettere e cifre: memorizzali come testo.
icao StringSWACodice ICAO della compagnia aerea a tre lettere, utile per passare da un sistema di codici all’altro.
marketing_name StringSouthwest AirlinesNome della compagnia aerea comunemente usato per la visualizzazione nella tua applicazione.
status Integer1Stato operativo: 1 = attiva, 0 = non attiva, 2 = in fase di avvio.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica l’elenco dei codici delle compagnie aeree

Usa dump=1 per esportare il database. Aggiungi onlyscheduled=0 per includere tutti i tipi di compagnia aerea invece del filtro predefinito sulle compagnie di linea. Questo esempio CSV si può importare nel tuo database; quando crei una ricerca per codice ICAO, conserva i record con il campo icao valorizzato. Controlla type_code se devi escludere altri tipi di vettore, come i record di treni, autobus e traghetti.

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

Trova un codice ICAO dal nome della compagnia aerea

Cerca con name, poi leggi icao da ogni record restituito. Le ricerche per nome supportano la corrispondenza parziale, quindi controlla le identità delle compagnie restituite invece di presumere che il primo risultato sia l’unico valido.

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

Associa un codice IATA a un codice ICAO

Passa il codice IATA in iata e leggi il campo icao restituito. Ad esempio, usa WN da un fornitore di prenotazioni per trovare SWA e confrontarlo con un set di dati aeronautici.

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

Cosa puoi creare

Arricchimento dei dati aeronautici

Trasforma i codici ICAO delle compagnie aeree di un set di dati aeronautici in nomi leggibili per dashboard e report.

Collega i dati di prenotazione e quelli aeronautici

Associa gli identificativi IATA dei fornitori di prenotazioni agli identificativi ICAO di altre fonti, verificando che entrambi i record si riferiscano al vettore giusto.

Elenchi di operatori

Crea una ricerca locale di compagnie aeree per operatori di linea, cargo o charter, con filtri espliciti per tipo e stato operativo.

Domande frequenti

Che cos’è un codice ICAO di compagnia aerea?

È un codice di compagnia aerea a tre lettere, come SWA per Southwest Airlines. Questa pagina riguarda gli identificativi delle compagnie aeree; per gli identificativi degli aeroporti usa l’API aeroporti.

In che cosa i codici ICAO delle compagnie aeree differiscono dai codici IATA?

I codici ICAO delle compagnie aeree hanno tre lettere, mentre i codici IATA hanno due caratteri e possono includere cifre. L’API compagnie aeree fornisce entrambi i campi, dove disponibili. Usa il parametro che corrisponde al sistema di codici della tua fonte dati: invia i codici ICAO in icao e i codici IATA in iata.

Posso convertire tra codici ICAO e IATA delle compagnie aeree?

Cerca un codice ICAO con icao e leggi iata dal risultato, oppure cerca un codice IATA con iata e leggi icao. Verifica che il campo di destinazione sia valorizzato prima di usare l’associazione; non dare per scontato che ogni record abbia entrambi i codici. Mantieni a disposizione il codice ICAO e l’identità della compagnia anche quando manca l’associazione IATA.

Posso cercare operatori cargo e charter?

Imposta onlyscheduled=0 per includere anche i tipi di compagnia aerea esclusi dal filtro predefinito sulle compagnie di linea. Controlla type_code per selezionare le categorie di operatori che ti servono e status se la tua applicazione deve includere solo le compagnie attive. Il filtro predefinito onlyscheduled=1 seleziona le compagnie di linea.

parent_icao identifica la compagnia operativa di un volo?

No. Il riferimento dell’API compagnie aeree definisce parent_icao come codice ICAO di una compagnia capogruppo, dove applicabile. Per identificare la compagnia operativa di un volo specifico, usa l’identificativo del vettore fornito dal tuo fornitore di voli e cerca quel vettore separatamente.

Come devo gestire una ricerca non risolta?

Se non riesci a risolvere una compagnia aerea, conserva il codice originale della fonte come riserva e gestisci gli errori di richiesta separatamente dalle corrispondenze mancanti. Per le ricerche parziali per nome, confronta nomi e codici restituiti prima di selezionare un record.

Posso tenere un elenco ICAO delle compagnie aeree nel mio database?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta con dump=1 in JSON, XML o CSV, poi conserva i campi che servono alla tua integrazione. Salva airhex_id insieme alle associazioni dei codici e aggiorna periodicamente la tua copia. Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree; l’API modifiche fornisce un registro delle modifiche recenti. Quando aggiorni i record, conserva il timestamp updated della risposta completa.

Questo endpoint offre il tracciamento dei voli in tempo reale o lo stato dei voli?

No. Fornisce dati di riferimento sulle compagnie aeree per identificare i vettori e associare i codici. Per le informazioni sui voli in tempo reale rivolgiti al tuo fornitore di dati sui voli. Il campo status restituito descrive lo stato operativo della compagnia aerea, non un singolo volo.

Crea la tua ricerca per codice ICAO delle compagnie aeree

Associa le identità delle compagnie aeree tra fonti di dati aeronautici e mantieni coerenti i nomi dei vettori in dashboard, report e strumenti rivolti ai passeggeri.

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.