API check-in online delle compagnie aeree

Aiuta i viaggiatori a raggiungere il check-in online della loro compagnia aerea dal tuo itinerario o da un messaggio prima del viaggio. Recupera gli URL del check-in online associati a codici e nomi delle compagnie, pronti da usare nella tua applicazione di viaggio.

Chiave API di prova Vedi l’esempio
  • Link al check-in online
  • Ricerca per codice o nome
  • JSON, XML e CSV

Ottieni i link al check-in online di una compagnia aerea

Cerca Southwest Airlines con il suo codice IATA WN e leggi web_checkin_url. Usa un URL restituito per indirizzare i viaggiatori alla pagina di check-in della compagnia. 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",
    "web_checkin_url": "https://www.southwest.com/air/check-in/?clk=HP-CHKIN",
    ...
  }
]

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

Usa l’API compagnie aeree per recuperare una compagnia o esportare l’elenco. web_checkin_url è un campo della risposta. La richiesta identifica la compagnia aerea: non invia una prenotazione di un passeggero per il check-in.

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

Associa web_checkin_url all’identità della compagnia prima di mostrarlo. Questo campo rimanda alla pagina di check-in della compagnia: non contiene lo stato del check-in di un passeggero né la carta d’imbarco.

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.
web_checkin_url String (URL)https://www.southwest.com/air/check-in/?clk=HP-CHKINURL del check-in online per i passeggeri.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica i link al check-in per il tuo elenco di compagnie aeree

Esporta l’elenco in CSV e conserva web_checkin_url insieme a nomi, codici e airhex_id delle compagnie aeree. Verifica che l’URL sia valorizzato prima di mostrare un pulsante di check-in. Usa onlyscheduled=0 se ti servono tipi di vettore oltre alle compagnie di linea e seleziona i record rilevanti nella 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-check-in-links.csv

Trova i link al check-in dal nome della compagnia aerea

Cerca con name, conferma la compagnia aerea giusta e leggi web_checkin_url. Le ricerche per nome supportano la corrispondenza parziale, quindi controlla le identità restituite prima di associare un link a un itinerario.

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

Recupera i link al check-in con un codice ICAO

Usa icao quando la tua fonte fornisce un codice ICAO di compagnia aerea a tre lettere. Questo esempio cerca Southwest Airlines con SWA e restituisce lo stesso campo web_checkin_url.

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

Cosa puoi creare

Pulsanti di check-in negli itinerari

Offri ai viaggiatori un link chiaramente etichettato alla pagina di check-in della loro compagnia aerea dalla schermata di gestione del viaggio.

Promemoria di check-in prima del viaggio

Aggiungi i link al check-in della compagnia aerea ai promemoria, usando le tempistiche stabilite dai dati di prenotazione o della compagnia.

Indicazioni sul check-in per i team di assistenza

Permetti agli operatori di recuperare i link al check-in online della compagnia aerea dal codice del vettore di una prenotazione.

Domande frequenti

Che cosa restituisce l’API check-in online delle compagnie aeree?

L’API compagnie aeree restituisce web_checkin_url insieme all’identità della compagnia. Questo campo contiene un link alla pagina di check-in online per i passeggeri della compagnia aerea.

Questa API effettua il check-in dei passeggeri o emette carte d’imbarco?

No. Fornisce gli URL del check-in delle compagnie aeree. Il passeggero completa il check-in presso la compagnia, che gestisce verifica della prenotazione, dati del passeggero ed emissione della carta d’imbarco.

La risposta indica quando si apre il check-in?

No. Il campo documentato fornisce un URL, non gli orari di apertura specifici di un volo né l’idoneità del passeggero. Per sapere quando il check-in è disponibile usa le istruzioni della compagnia aerea o i dati di prenotazione appropriati. Basa promemoria e messaggi di disponibilità su quella finestra di check-in, non sulla presenza di un URL.

Posso precompilare il codice di prenotazione e il nome del passeggero?

L’API documentata restituisce URL di check-in e non definisce parametri di precompilazione dei dati del passeggero. Non dare per scontato di poter aggiungere i dettagli della prenotazione a un URL restituito. Se una compagnia aerea offre un metodo di integrazione documentato, segui quello.

Quale link di check-in devo mostrare per un codeshare?

Segui le istruzioni di check-in associate alla prenotazione per individuare il vettore appropriato, poi cerca quella compagnia aerea. L’API di riferimento non stabilisce a chi spetti il check-in per un singolo itinerario.

Che cosa devo fare se web_checkin_url manca?

Ometti il pulsante di check-in oppure offri un altro percorso di assistenza. L’assenza dell’URL non dimostra che il check-in online non sia disponibile per la prenotazione del passeggero.

Posso salvare i link al check-in nel mio database?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta l’elenco in JSON, XML o CSV e conserva l’identità delle compagnie insieme agli URL. Aggiorna periodicamente la tua copia; 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 agli URL.

Come devo mostrare un link di check-in?

Usa il web_checkin_url valorizzato come destinazione di un pulsante di check-in chiaramente etichettato. Includi il nome della compagnia aerea, così i viaggiatori sanno di quale compagnia aerea è la pagina che apriranno.

Rendi più facile trovare il check-in della compagnia aerea

Offri ai viaggiatori un percorso diretto dal tuo itinerario o promemoria alla pagina di check-in online della loro compagnia aerea, con link curati e associati ai codici delle compagnie.

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.