API alleanze aeree

Aiuta i viaggiatori a trovare le compagnie aeree della loro alleanza preferita. Recupera l’appartenenza all’alleanza insieme a nomi e codici delle compagnie per aggiungere etichette, filtri e confronti tra compagnie aeree alla tua applicazione di viaggio.

Chiave API di prova Vedi l’esempio
  • Alleanza di appartenenza della compagnia aerea
  • Ricerca per codice o nome
  • JSON, XML e CSV

Cerca l’alleanza di una compagnia aerea

Cerca United Airlines con il suo codice IATA UA e leggi alliance. Questo esempio restituisce Star Alliance. 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",
    "alliance": "Star Alliance",
    ...
  }
]

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 alliance dai record restituiti. L’endpoint documentato non ha un parametro di richiesta alliance: raggruppa o filtra i record nella tua applicazione.

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 alliance per mostrare l’appartenenza accanto all’identità della compagnia aerea. Conserva status quando crei un elenco dei soli membri attivi e airhex_id quando aggiorni i tuoi record locali.

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.
status Integer1Stato operativo: 1 = attiva, 0 = non attiva, 2 = in fase di avvio.
alliance StringStar AllianceAlleanza di appartenenza della compagnia aerea, se applicabile.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica l’elenco e raggruppa le compagnie aeree per alleanza

Esporta l’elenco in CSV, poi raggruppa i record per il campo alliance nella tua applicazione. Filtra per il nome dell’alleanza restituito per creare un elenco dei membri e controlla status se vuoi solo le compagnie attive. onlyscheduled=0 amplia la copertura dei tipi di vettore; controlla type_code per selezionare i record che servono al tuo prodotto.

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-alliances.csv

Trova l’alleanza di appartenenza dal nome della compagnia aerea

Cerca con name, seleziona la compagnia aerea giusta e leggi alliance. La corrispondenza parziale dei nomi può restituire più record, quindi conferma l’identità della compagnia prima di mostrarne l’appartenenza.

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

Recupera l’alleanza di appartenenza con un codice ICAO

Usa icao quando la tua fonte fornisce un codice ICAO di compagnia aerea a tre lettere. Questo esempio recupera United Airlines con UAL e legge alliance dallo stesso record 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

Filtri per alleanza nella ricerca voli

Associa i codici delle compagnie aeree dei fornitori al tuo elenco e permetti ai viaggiatori di restringere i risultati per alleanza, con un trattamento chiaro di compagnia commerciale e compagnia operativa.

Pagine di confronto tra compagnie aeree

Mostra l’alleanza indicata accanto al nome di ciascuna compagnia aerea per aiutare i viaggiatori a confrontare i vettori.

Elenchi dei membri delle alleanze

Raggruppa i record delle compagnie aeree per appartenenza per creare elenchi consultabili e report interni.

Domande frequenti

Che cosa restituisce l’API alleanze aeree?

Il campo alliance indica l’alleanza di appartenenza di una compagnia aerea, se applicabile. Fa parte del record dell’API compagnie aeree insieme a nomi, codici IATA, codici ICAO e altri dati di riferimento.

Posso recuperare tutte le compagnie aeree di una determinata alleanza?

Esporta l’elenco con dump=1 e filtra i valori alliance restituiti nella tua applicazione. L’endpoint documentato non prevede un parametro di richiesta per l’alleanza. Controlla status se l’elenco dei membri deve includere solo le compagnie attive. Crea i gruppi a partire dai valori alliance valorizzati e conserva nome e codici della compagnia in ogni record, per associare i vettori nei risultati di ricerca.

Posso cercare l’appartenenza con codice IATA, codice ICAO o nome?

Sì. Usa iata, icao o name per recuperare i record delle compagnie aeree, poi leggi alliance. La corrispondenza sui nomi supporta le ricerche parziali, quindi seleziona la compagnia giusta prima di usare il risultato.

Che cosa devo mostrare quando alliance è vuoto?

Ometti l’etichetta dell’alleanza oppure mostra “Nessuna alleanza indicata”, in base al design del tuo prodotto. Non dedurre l’appartenenza da una compagnia capogruppo, da un partner di codeshare o dal nome di una compagnia simile.

Se una compagnia appartiene a un’alleanza, il passeggero accumula miglia o accede alle lounge?

No. Questo campo descrive l’appartenenza della compagnia aerea e non stabilisce i vantaggi per un singolo passeggero o biglietto. Per verificare l’idoneità usa le regole del programma fedeltà e i dettagli della prenotazione.

Come gestire i codeshare nei filtri per alleanza?

Decidi se il filtro si applica alla compagnia commerciale, alla compagnia operativa o a entrambe, e spiega questa scelta ai viaggiatori. Cerca separatamente ogni compagnia indicata nell’itinerario: il campo alliance non stabilisce le relazioni di codeshare di un volo.

Posso salvare l’appartenenza alle alleanze nel mio database?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta in JSON, XML o CSV e conserva l’identità della compagnia insieme al valore alliance. Aggiorna periodicamente l’elenco; Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree. Memorizza airhex_id e il timestamp updated della risposta completa per rilevare i cambi di appartenenza e di stato delle compagnie.

Questa API restituisce l’appartenenza storica alle alleanze?

Il campo alliance documentato indica l’appartenenza riportata nel record della compagnia aerea. Non fornisce intervalli di date di appartenenza né una ricerca a una data specifica. Se i tuoi report richiedono confronti storici, conserva snapshot datati per conto tuo.

Aiuta i viaggiatori a trovare le compagnie aeree della loro alleanza preferita

Aggiungi filtri per alleanza ed etichette di appartenenza al tuo prodotto di viaggio senza dover mantenere in proprio gli elenchi dei membri.

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 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.