API regole sui bagagli delle compagnie aeree

Aiuta i viaggiatori a trovare le regole sui bagagli della loro compagnia aerea direttamente dal flusso di prenotazione o dall’itinerario. Recupera gli URL ufficiali delle regole associati a codici e nomi delle compagnie, oppure scarica l’elenco per la tua applicazione.

Chiave API di prova Vedi l’esempio
  • Link ufficiali alle regole sui bagagli
  • Ricerca per codice o nome
  • JSON, XML e CSV

Ottieni il link alle regole sui bagagli di una compagnia aerea

Cerca Southwest Airlines con il suo codice IATA WN e leggi baggage_url. Usa l’URL restituito per il link alle regole sui bagagli nella tua applicazione. 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",
    "baggage_url": "https://support.southwest.com/helpcenter/pathway/baggage",
    ...
  }
]

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 singola compagnia o esportare l’elenco. baggage_url è un campo della risposta: non servono un endpoint separato per le regole sui bagagli né un parametro di richiesta baggage_url.

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 baggage_url all’identità della compagnia prima di mostrarlo. L’API fornisce un link alla pagina delle regole della compagnia: non restituisce franchigie, dimensioni o costi strutturati dei bagagli per un biglietto specifico.

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.
baggage_url String (URL)https://support.southwest.com/helpcenter/pathway/baggageURL delle regole della compagnia aerea sulla franchigia bagaglio.

Vedi tutti i dati disponibili →

Attività comuni di implementazione

Scarica i link alle regole sui bagagli per il tuo elenco di compagnie aeree

Esporta l’elenco delle compagnie aeree in CSV, poi conserva baggage_url insieme a nomi, codici e airhex_id. Mostra un link alle regole solo quando l’URL è presente. Usa onlyscheduled=0 se ti servono anche 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-baggage-links.csv

Trova le regole sui bagagli dal nome della compagnia aerea

Cerca con name, seleziona la compagnia aerea giusta e leggi baggage_url. La corrispondenza parziale dei nomi può restituire più record, quindi conferma l’identità prima di mostrare il link alle regole.

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

Recupera il link alle regole con un codice ICAO

Usa icao se la tua fonte identifica la compagnia aerea con un codice ICAO a tre lettere. Questo esempio recupera Southwest Airlines con SWA e restituisce lo stesso record della compagnia e lo stesso campo delle regole sui bagagli.

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

Cosa puoi creare

Indicazioni sui bagagli durante la prenotazione

Dai ai viaggiatori accesso alle regole della compagnia aerea mentre controllano l’itinerario e la franchigia bagaglio del biglietto.

Comunicazioni utili prima del viaggio

Inserisci un link chiaramente etichettato alle regole sui bagagli della compagnia aerea nelle conferme di prenotazione e nei messaggi prima della partenza.

Assistenza clienti più rapida

Permetti agli operatori di trovare il link alle regole della compagnia aerea di una prenotazione senza mantenere un elenco separato di URL.

Domande frequenti

Che cosa restituisce l’API regole sui bagagli delle compagnie aeree?

Il campo baggage_url contiene un URL alle regole della compagnia aerea sulla franchigia bagaglio. Viene restituito nel record dell’API compagnie aeree insieme a nome, codici e altri dati di riferimento.

L’API restituisce pesi, dimensioni o costi dei bagagli?

Questo campo restituisce un URL alle regole, non dati strutturati su franchigie o prezzi. I viaggiatori possono seguire il link alle regole della compagnia. Per le franchigie bagaglio del singolo biglietto e le opzioni acquistabili rivolgiti al tuo fornitore di prenotazioni.

Posso usare il link alle regole per capire che cosa include una tariffa?

No. Un link generale alle regole della compagnia aerea non stabilisce la franchigia bagaglio di una singola prenotazione. Usa la franchigia fornita con la tariffa o il biglietto selezionato e proponi il link alle regole come ulteriore riferimento.

Posso recuperare le regole con codice IATA, codice ICAO o nome?

Sì. Usa iata, icao o name per recuperare il record di una compagnia aerea, poi leggi baggage_url. Le ricerche per nome supportano la corrispondenza parziale, quindi verifica la compagnia restituita prima di usarne il link.

Quale link devo mostrare per un codeshare o un itinerario con più compagnie aeree?

Associa ogni link alle regole al record della compagnia aerea a cui appartiene ed etichettalo con il nome di quella compagnia. Non usare questo campo da solo per decidere quali regole del vettore si applicano al biglietto: usa le informazioni sui bagagli fornite con la prenotazione. Usa un’etichetta chiara come “Vedi le regole della compagnia sui bagagli”, così i viaggiatori sanno che cosa apriranno.

Che cosa devo fare quando baggage_url è vuoto?

Non mostrare un link vuoto o non funzionante. Ometti il pulsante delle regole oppure offri un altro percorso di assistenza nella tua applicazione. L’assenza del dato non dimostra che la compagnia aerea consenta o vieti un determinato bagaglio, né che non abbia regole sui bagagli.

Posso salvare i link alle regole sui bagagli nel mio database?

Sì, con una licenza adeguata del database delle compagnie aeree. Esporta con dump=1 in JSON, XML o CSV e conserva l’identità della compagnia con ciascun URL. 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, così le importazioni rilevano le modifiche agli URL.

L’API fornisce il testo delle regole o versioni tradotte?

Il campo baggage_url documentato fornisce un URL, non il testo delle regole né varianti in altre lingue. È la pagina di destinazione della compagnia aerea a determinare contenuti e lingue disponibili per il viaggiatore.

Aiuta i viaggiatori a trovare le regole sui bagagli della loro compagnia aerea

Porta i link alle regole delle compagnie aeree dove servono ai viaggiatori — nei flussi di prenotazione, negli itinerari e negli strumenti di assistenza — senza mantenere un elenco separato di URL.

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.