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, conserva solo i record con un codice IATA.
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 IATA dal nome della compagnia aerea
Cerca con name, poi leggi iata 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 ICAO a un codice IATA
Passa il codice ICAO in icao e leggi il campo iata restituito. Questo aiuta a riconciliare gli identificativi delle compagnie aeree provenienti da fonti dati diverse.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=SWA'
Domande frequenti
Che differenza c’è tra codici IATA delle compagnie aeree, codici aeroportuali e codici ICAO?
Un codice IATA di compagnia aerea è un identificativo a due caratteri, come WN per Southwest Airlines, e può includere cifre. I codici aeroportuali IATA identificano le località e hanno tre lettere. I codici ICAO delle compagnie aeree sono un sistema separato a tre lettere; il codice ICAO di Southwest è SWA.
Posso associare le compagnie aeree del mio fornitore di prenotazioni di voli?
Se il tuo fornitore restituisce un codice IATA di compagnia aerea, passalo nel parametro iata per recuperare il nome della compagnia e i relativi dati di riferimento. Per un fornitore che restituisce codici ICAO, usa invece icao. Prima di eseguire l’associazione, verifica quale sistema di codici usa ciascun campo del fornitore.
Come devo gestire le compagnie commerciali e operative?
Usa gli identificativi del vettore commerciale e del vettore operativo forniti con il volo e cerca ogni vettore separatamente. Potrai poi mostrare la compagnia commerciale e, dove opportuno, un’etichetta “operato da”. Questo endpoint di riferimento non stabilisce quale vettore operi un determinato volo.
Ogni record di compagnia aerea ha un codice IATA?
Non dare per scontato che ogni record abbia un codice IATA. Verifica che il campo iata sia valorizzato prima di aggiungere un record alla tua ricerca IATA. Quando mantieni l’elenco locale, conserva airhex_id come identificatore permanente del record invece di usare il codice della compagnia come chiave permanente.
Come gestire nella mia integrazione le corrispondenze mancanti o ambigue?
Gestisci le richieste non riuscite separatamente dalle ricerche che non trovano alcuna compagnia aerea. Se non riesci a risolvere un codice, conserva quello originale del fornitore come riserva da mostrare. Le ricerche per nome supportano la corrispondenza parziale, quindi confronta identità e codici disponibili invece di scegliere automaticamente il primo record.
Posso scaricare e salvare l’elenco nel mio database?
Sì, con una licenza adeguata del database delle compagnie aeree. Usa dump=1 per esportare l’elenco in JSON, XML o CSV e imposta onlyscheduled=0 se ti servono tutti i tipi di compagnia. Una copia locale permette alla tua applicazione di risolvere i nomi delle compagnie senza una richiesta API per ogni risultato di volo. Quando richiedi l’accesso, conferma i diritti d’uso per la tua integrazione.
Come mantengo aggiornati i codici delle compagnie aeree?
Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree. Aggiorna periodicamente il tuo elenco locale e conserva airhex_id e updated quando importi i record. L’API modifiche fornisce un registro delle modifiche recenti: usalo per monitorare i cambiamenti e recuperare i record aggiornati dall’API compagnie aeree. Quando pianifichi il processo di aggiornamento, consulta il riferimento completo dell’API compagnie aeree e la documentazione dell’API modifiche.
Include disponibilità dei voli, tariffe o stato dei voli?
No. Questo endpoint fornisce dati di riferimento sulle compagnie aeree per identificarle e mostrarle. Per disponibilità, tariffe e stato dei singoli voli rivolgiti al tuo fornitore di voli. Il campo status qui descrive lo stato operativo della compagnia aerea, non lo stato di un volo.
Come scelgo quali tipi di compagnia aerea includere?
Il filtro predefinito onlyscheduled=1 seleziona le compagnie aeree di linea. Usa onlyscheduled=0 per tutti i tipi di compagnia e controlla status quando la tua applicazione deve mostrare solo le compagnie attive.