Parametri della richiesta
Cerca una compagnia aerea o esporta l’elenco, poi leggi lowcost, type e type_code. Usa onlyscheduled per controllare la copertura dei tipi. L’endpoint documentato non ha parametri di richiesta lowcost o type_code: applica questi filtri ai record restituiti nella tua applicazione.
| Parametro | Obbligatorio | Predefinito | Descrizione |
|---|
apikey |
Sì | Nessuno | La tua chiave API. Richiedi una chiave API di prova gratuita. |
|---|
iata |
Condizionale | Nessuno | Cerca una compagnia aerea tramite il suo codice IATA a due caratteri, ad esempio UA. |
|---|
icao |
Condizionale | Nessuno | Cerca una compagnia aerea tramite il suo codice ICAO a tre lettere, ad esempio UAL. |
|---|
name |
Condizionale | Nessuno | Trova i codici delle compagnie aeree tramite il nome, anche parziale. |
|---|
dump |
Condizionale | 0 | Imposta 1 per esportare l’intero set di dati, con il filtro onlyscheduled ancora attivo. |
|---|
response_type |
No | JSON | Formato della risposta: JSON, XML o CSV. Con CSV parte il download di un file. |
|---|
onlyscheduled |
No | 1 | Imposta 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 →
Attività comuni di implementazione
Scarica e filtra le classificazioni delle compagnie aeree
Esporta con dump=1 e onlyscheduled=0 per includere anche categorie diverse dalle compagnie di linea. Nella tua applicazione, seleziona lowcost uguale a 1 per le compagnie low cost, oppure un type_code come 2 per i charter passeggeri o 8 per il cargo. Normalizza le stringhe numeriche prima di confrontare i valori e tieni la classificazione low cost separata dal tipo di compagnia aerea.
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-metadata.csv
Trova i metadati di una compagnia aerea dal nome
Cerca con name, conferma la compagnia aerea giusta e leggi i suoi campi di classificazione. onlyscheduled=0 permette di cercare anche oltre le compagnie di linea. La corrispondenza parziale dei nomi può restituire più record, quindi verificane l’identità prima di applicare le etichette.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=United' \
--data-urlencode 'onlyscheduled=0'
Recupera le classificazioni con un codice ICAO
Usa icao quando la tua fonte fornisce un codice di compagnia aerea a tre lettere. Questo esempio recupera United Airlines con UAL. Includi onlyscheduled=0 quando la tua ricerca deve coprire anche altri tipi di operatore.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=UAL' \
--data-urlencode 'onlyscheduled=0'
Domande frequenti
Che cosa restituisce l’API metadati delle compagnie aeree?
Questa pagina riguarda lowcost, type e type_code nella risposta dell’API compagnie aeree. Identificano il flag delle compagnie low cost, l’etichetta della categoria della compagnia aerea e il corrispondente codice di categoria, insieme a nomi e identificatori delle compagnie.
Che cosa significano i valori di lowcost?
1 identifica una compagnia low cost. 0 significa che il record della compagnia aerea non è contrassegnato come low cost. È una classificazione del vettore, non un’indicazione sul prezzo o sui servizi inclusi in una singola tariffa. Per franchigie bagaglio e servizi inclusi usa i dati tariffari del tuo fornitore di prenotazioni.
Una compagnia aerea può essere sia di linea sia low cost?
Sì. “Di linea” è una categoria della compagnia aerea, mentre lowcost è un flag separato. Usa entrambi i campi quando la tua applicazione ha bisogno di compagnie di linea low cost. Seleziona la categoria con type_code e la classificazione low cost con lowcost.
Quali tipi di compagnia aerea sono disponibili?
I codici documentati sono 1 Di linea, 2 Charter passeggeri, 3 Treno/bus/traghetto, 4 Charter elicotteri, 5 Charter jet, 6 Voli turistici, 7 ACMI, 8 Cargo e 9 Altri. Usa type_code per i filtri di categoria e type per l’etichetta fornita.
Come recupero gli operatori charter o cargo?
Imposta onlyscheduled=0 per includere tipi oltre alle compagnie di linea. Per un elenco, esporta con dump=1 e filtra in locale per type_code 2 (Charter passeggeri) oppure 8 (Cargo). Charter elicotteri e Charter jet hanno codici separati, 4 e 5.
Posso passare lowcost o type_code come parametro di query?
Sono campi della risposta, non filtri di richiesta documentati. Recupera i record che ti servono e filtrali nella tua applicazione. onlyscheduled è il parametro di richiesta documentato per scegliere tra le sole compagnie di linea e una copertura più ampia dei tipi. Il valore predefinito di onlyscheduled è 1. Impostalo a 0 per una copertura più ampia, poi seleziona esplicitamente le categorie di compagnie aeree se il tuo elenco deve escludere i record di treni, autobus e traghetti.
onlyscheduled=1 significa che la compagnia aerea è attiva?
No. Categoria della compagnia aerea e stato operativo sono attributi separati. Leggi il campo status se devi distinguere compagnie attive, non attive e in fase di avvio.
Posso salvare i metadati delle compagnie aeree nel mio database?
Sì, con una licenza adeguata del database delle compagnie aeree. Esporta in JSON, XML o CSV e conserva airhex_id insieme alle classificazioni. Aggiorna periodicamente i tuoi record locali; Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree.
Come devo gestire flag numerici e valori mancanti?
Normalizza le stringhe numeriche prima di confrontare lowcost con 0 o 1. Conserva i valori mancanti o inattesi come sconosciuti invece di assegnare loro un’etichetta in modo implicito.