API programmi fedeltà delle compagnie aeree

Collega l’identità delle compagnie aeree ai nomi dei loro programmi fedeltà. Recupera i nomi dei programmi insieme ai codici delle compagnie per arricchire i profili, creare elenchi di programmi fedeltà e fornire un contesto utile nella tua applicazione di viaggio.

Chiave API di prova Vedi l’esempio
  • Nomi dei programmi fedeltà
  • Ricerca per codice o nome
  • JSON, XML e CSV

Cerca il programma fedeltà di una compagnia aerea

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

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 ffp_name dai record restituiti. Il parametro name cerca nei nomi delle compagnie aeree, non nei nomi dei programmi fedeltà. Dopo aver recuperato i record, filtra i nomi dei programmi 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 ffp_name per mostrare il programma associato al record della compagnia aerea. Quando crei o aggiorni un elenco locale, mantieni l’identità della compagnia insieme al nome del programma.

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.
ffp_name StringMileagePlusNome del programma fedeltà della compagnia aerea.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica i nomi dei programmi fedeltà delle compagnie aeree

Esporta l’elenco in CSV e conserva ffp_name insieme a nomi, codici e airhex_id delle compagnie aeree. Usa i nomi dei programmi valorizzati per creare un elenco. Imposta onlyscheduled=0 se ti servono tipi di vettore oltre alle compagnie di linea, poi seleziona i record rilevanti per la 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=CSV' \
  --output airline-frequent-flyer-programs.csv

Trova un programma dal nome della compagnia aerea

Cerca con il nome della compagnia aerea, seleziona il record giusto e leggi ffp_name. La corrispondenza parziale dei nomi può restituire più compagnie, quindi conferma l’identità prima di mostrare un programma. Per cercare il nome di un programma, filtra in locale l’elenco scaricato.

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

Recupera il nome di un programma 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 e legge il nome del suo programma fedeltà dallo stesso record.

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

Cosa puoi creare

Profili utili delle compagnie aeree

Mostra il programma fedeltà indicato accanto al nome della compagnia aerea e ad altre informazioni di riferimento.

Elenchi dei programmi fedeltà delle compagnie aeree

Crea un elenco consultabile che collega nomi e codici delle compagnie aeree ai programmi fedeltà indicati.

Contesto per i team di assistenza ai viaggi

Fornisci agli operatori il nome del programma della compagnia aerea quando esaminano una prenotazione, mantenendo le domande su account e vantaggi legate al programma pertinente.

Domande frequenti

Che cosa restituisce l’API programmi fedeltà delle compagnie aeree?

Il campo ffp_name restituisce il nome del programma fedeltà della compagnia aerea. È incluso nel record dell’API compagnie aeree insieme a nomi, codici e altri dati di riferimento.

Posso cercare un programma a partire dal codice di una compagnia aerea?

Sì. Passa un codice IATA della compagnia in iata o un codice ICAO in icao, poi leggi ffp_name. Puoi anche cercare usando il nome della compagnia.

Posso cercare direttamente il nome di un programma fedeltà?

Il parametro name documentato cerca nei nomi delle compagnie aeree, non nei nomi dei programmi. Esporta l’elenco con dump=1 e cerca o filtra ffp_name in locale se la tua applicazione richiede la ricerca per nome del programma.

Questa API fornisce il saldo miglia o convalida i numeri di socio?

No. ffp_name è un dato di riferimento della compagnia aerea. Non fornisce account dei passeggeri, saldi, convalida dei numeri di socio né accesso a un account fedeltà.

Posso usare ffp_name per stabilire a quale programma un passeggero può accreditare un volo?

No. Il campo identifica il programma indicato nel record della compagnia aerea, non tutti i programmi partner accettati per una determinata prenotazione. Per stabilire accredito miglia e idoneità usa le regole della tariffa e del programma fedeltà pertinenti. Il solo nome non indica quantità di miglia né vantaggi per il passeggero.

Il nome di un programma è un identificatore univoco?

La documentazione dell’API non definisce ffp_name come identificatore univoco del programma. Conserva il legame con la compagnia aerea tramite airhex_id e i suoi codici, invece di trattare il nome visualizzato come chiave permanente del record.

Che cosa devo fare se ffp_name è vuoto?

Ometti l’etichetta del programma oppure mostra “Nessun programma indicato”, in base al design del tuo prodotto. Un valore vuoto non stabilisce se la compagnia aerea partecipi ad altri accordi fedeltà. Non dedurre un programma dall’alleanza o dal vettore capogruppo della compagnia.

Posso scaricare e salvare i nomi dei programmi nel mio database?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta in JSON, XML o CSV e conserva l’identità delle compagnie insieme ai nomi dei programmi. Aggiorna periodicamente i record salvati; Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree. Conserva airhex_id e il timestamp updated della risposta completa per rilevare le modifiche ai nomi dei programmi.

Aiuta i viaggiatori a riconoscere i programmi fedeltà delle compagnie aeree

Mostra i nomi dei programmi fedeltà accanto alle informazioni sulle compagnie aeree, offrendo a viaggiatori e team di assistenza un contesto utile senza mantenere un elenco separato dei programmi.

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.