API stato delle compagnie aeree

Verifica se una compagnia aerea è attiva, non attiva o se è una start-up in attesa di iniziare le operazioni. Recupera il suo stato operativo insieme a codici e nomi delle compagnie per mantenere il tuo elenco e creare selettori di compagnie adatti.

Chiave API di prova Vedi l’esempio
  • Attiva, non attiva e in fase di avvio
  • Ricerca per codice o nome
  • JSON, XML e CSV

Verifica lo stato operativo di una compagnia aerea

Cerca Southwest Airlines con il suo codice IATA WN e leggi il campo status. Il valore 1 significa che la compagnia aerea è attiva. 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=WN'

Risposta · estratto JSON

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

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 scarica l’elenco, poi leggi il campo status nella risposta. L’endpoint documentato non offre un parametro di richiesta per lo stato: applica i filtri su status 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 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

Leggi status insieme all’identità della compagnia aerea. I valori sono 1 per attiva, 0 per non attiva e 2 per una start-up in attesa di iniziare le operazioni. Quando mantieni i tuoi record locali, conserva airhex_id.

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, in attesa di iniziare le operazioni.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica l’elenco e filtra per stato

Esporta l’elenco in CSV e filtra la colonna status nella tua applicazione: conserva 1 per le compagnie attive, 0 per quelle non attive oppure 2 per le start-up. Impostare onlyscheduled=0 amplia la copertura dei tipi di compagnia aerea, ma non è un filtro sulle compagnie attive. Controlla type_code se devi escludere i record di treni, autobus o 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 airline-status.csv

Trova lo stato di una compagnia aerea dal nome

Cerca con name, seleziona la compagnia aerea giusta tra i record corrispondenti e leggi status. La corrispondenza parziale dei nomi può restituire più di una compagnia. Includi onlyscheduled=0 quando vuoi cercare oltre le compagnie di linea.

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

Verifica lo stato con un codice ICAO

Usa icao quando la tua fonte identifica il vettore con un codice ICAO a tre lettere. Questo esempio recupera Southwest Airlines con SWA. Leggi il valore status restituito invece di dedurre lo stato operativo dalla sola presenza di un codice.

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

Cosa puoi creare

Verifica le compagnie attive nei tuoi strumenti di prenotazione

Crea un selettore a partire dai record con status 1, applicando i filtri sul tipo di vettore che servono al tuo prodotto.

Report storici sui viaggi

Mantieni disponibili le identità delle compagnie non più attive per spiegare prenotazioni, itinerari e transazioni meno recenti.

Manutenzione dell’elenco

Confronta i record aggiornati tramite airhex_id e segnala i cambi di stato per la revisione nei tuoi strumenti interni.

Domande frequenti

Che cosa significano i valori dello stato delle compagnie aeree?

1 significa attiva, 0 significa non attiva e 2 significa una start-up in attesa di iniziare le operazioni. Questi valori descrivono la compagnia aerea come organizzazione.

Lo stato attivo significa che un volo è prenotabile?

No. Lo stato attivo di una compagnia aerea non stabilisce la disponibilità su una rotta o in una data. Per disponibilità e tariffe dei voli rivolgiti al tuo fornitore di prenotazioni.

Posso richiedere solo le compagnie aeree attive?

L’API compagnie aeree documentata non ha un parametro di richiesta per lo stato. Recupera i record che ti servono e filtra nella tua applicazione per status uguale a 1. onlyscheduled=1 seleziona i tipi di compagnia di linea: non sostituisce il controllo su status. Confronta esplicitamente con 1: un controllo diverso da zero includerebbe anche le start-up con status 2.

Come posso trovare le compagnie non più attive o le start-up?

Esporta l’elenco e filtra i record restituiti per status 0 o 2. Imposta onlyscheduled=0 se ti servono tutti i tipi di vettore. Per una singola compagnia aerea, cercane il codice o il nome e controlla lo status restituito.

Un codice di compagnia aerea mancante significa che la compagnia ha cessato l’attività?

No. Un codice mancante o una ricerca non risolta non è un valore di stato operativo. Conserva l’identificativo originale e verifica la corrispondenza invece di etichettare la compagnia come non attiva. Assegna un’etichetta operativa solo quando un record restituito fornisce un valore di stato riconosciuto.

Devo rimuovere dal mio database le compagnie aeree non più attive?

Conserva i record che ti servono per risolvere prenotazioni o report storici. Puoi escludere i record con status 0 dai selettori correnti senza eliminarne l’identità storica. Usa airhex_id per associare le importazioni future ai record esistenti.

Come mantengo aggiornato lo stato delle compagnie aeree?

Airhex controlla e aggiorna ogni giorno i dati delle compagnie aeree. Aggiorna periodicamente i tuoi record locali e conserva airhex_id e il timestamp updated della risposta completa. L’API modifiche fornisce un registro delle modifiche recenti, inclusi i cambi di stato, per supportare il monitoraggio.

È un’API sullo stato dei voli in tempo reale?

No. Fornisce lo stato operativo delle compagnie aeree, non partenze, arrivi, ritardi o cancellazioni. Per lo stato di un singolo volo usa un fornitore di dati sui voli.

Mantieni aggiornato il tuo elenco di compagnie aeree

Mantieni visibili le compagnie attive nei selettori correnti, conservando le identità delle compagnie non più attive per prenotazioni e report storici.

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.