API politique bagages des compagnies aériennes

Aidez les voyageurs à trouver la politique de bagages de leur compagnie directement dans votre parcours de réservation ou leur itinéraire. Obtenez des liens officiels vers la politique, associés aux codes et aux noms des compagnies, ou téléchargez le répertoire pour votre propre application.

Clé d'API de test Voir l'exemple
  • Liens officiels vers la politique de bagages
  • Recherche par code ou par nom
  • JSON, XML et CSV

Obtenir le lien vers la politique de bagages d'une compagnie aérienne

Interrogez Southwest Airlines avec le code IATA WN et lisez baggage_url. Utilisez l'URL renvoyée comme lien vers la politique de bagages dans votre application. Remplacez YOUR_API_KEY par votre clé d'API.

Requête · cURL

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

Réponse · extrait JSON

[
  {
    "iata": "WN",
    "icao": "SWA",
    "marketing_name": "Southwest Airlines",
    "baggage_url": "https://support.southwest.com/helpcenter/pathway/baggage",
    ...
  }
]

Réponse abrégée. Les points de suspension (…) représentent d'autres champs de la compagnie omis ici, qui ne font pas partie de la réponse JSON réelle.

Voir la référence complète : API compagnies aériennes →

Paramètres de la requête

Avec l'API compagnies aériennes, vous interrogez une compagnie ou exportez le répertoire. baggage_url est un champ de la réponse ; il n'existe ni endpoint propre à la politique de bagages ni paramètre de requête baggage_url.

ParamètreObligatoirePar défautDescription
apikey OuiAucunVotre clé d'API. Obtenir une clé d'API de test gratuite.
iata ConditionnelAucunRecherche d'une compagnie par son code IATA à deux caractères, par exemple WN.
icao ConditionnelAucunRecherche d'une compagnie par son code OACI à trois lettres, par exemple SWA.
name ConditionnelAucunRecherche de codes de compagnies par nom complet ou partiel de la compagnie.
dump Conditionnel0Avec 1, exporte le jeu de données complet, selon le filtre onlyscheduled.
response_type NonJSONFormat de la réponse : JSON, XML ou CSV. CSV lance le téléchargement d'un fichier.
onlyscheduled Non1Avec 1, seules les compagnies régulières sont renvoyées ; avec 0, tous les types de compagnies.

Indiquez au moins l'un des paramètres iata, icao, name ou dump=1. Avec dump=1, les autres paramètres de recherche sont ignorés.

Voir tous les paramètres de la requête →

Données disponibles

Rattachez baggage_url à la compagnie avant d'afficher le lien. L'API renvoie un lien vers la page de la compagnie consacrée à sa politique ; elle ne renvoie ni données structurées sur la franchise de bagages, ni dimensions, ni frais de bagages pour un billet donné.

ChampTypeExempleDescription
airhex_id Identifiant1046Identifiant permanent de l'enregistrement chez Airhex. Utilisez-le pour rattacher les futures mises à jour au même enregistrement.
iata StringWNCode IATA à deux caractères de la compagnie. Les codes peuvent contenir des lettres et des chiffres ; stockez-les sous forme de texte.
icao StringSWACode OACI à trois lettres de la compagnie, utile pour passer d'un système de codes à un autre.
marketing_name StringSouthwest AirlinesNom commercial de la compagnie à afficher dans votre application.
baggage_url String (URL)https://support.southwest.com/helpcenter/pathway/baggageURL de la politique de bagages de la compagnie.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger les liens vers les politiques de bagages de votre répertoire de compagnies

Exportez le répertoire des compagnies en CSV et conservez baggage_url avec les noms, les codes et airhex_id. N'affichez un lien que si une URL est renseignée. Utilisez onlyscheduled=0 si vous avez aussi besoin de types de compagnies autres que régulières, et choisissez les enregistrements adaptés dans votre application.

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

Trouver la politique de bagages par nom de compagnie

Cherchez avec name, choisissez la compagnie voulue et lisez baggage_url. La recherche par nom accepte les correspondances partielles et peut renvoyer plusieurs enregistrements : confirmez la compagnie avant d'afficher son lien.

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

Obtenir le lien vers la politique avec un code OACI

Utilisez icao lorsque votre source identifie la compagnie par un code OACI à trois lettres. L'exemple interroge Southwest Airlines avec SWA et renvoie le même enregistrement de compagnie, avec le champ de la politique de bagages.

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

Ce que vous pouvez créer

Informations sur les bagages pendant la réservation

Donnez aux voyageurs accès à la politique de la compagnie pendant qu'ils vérifient l'itinéraire et la franchise de bagages de leur réservation.

Une communication utile avant le voyage

Ajoutez un lien clairement libellé vers la politique de bagages de la compagnie dans les confirmations de réservation et les messages précédant le départ.

Une assistance client plus rapide

Permettez aux conseillers de trouver le lien vers la politique de la compagnie d'une réservation sans tenir leur propre liste d'URL.

Questions fréquentes

Que renvoie l'API politique bagages des compagnies aériennes ?

Le champ baggage_url contient une URL vers la politique de bagages de la compagnie. Il figure dans l'enregistrement de l'API compagnies aériennes, avec le nom de la compagnie, les codes et d'autres données de référence.

L'API renvoie-t-elle des poids, des dimensions ou des frais de bagages ?

Le champ renvoie une URL vers la politique, et non des données structurées sur la franchise de bagages ou les prix. Les voyageurs suivent le lien vers la politique de la compagnie. La franchise incluse dans chaque réservation et les options de bagages payantes viennent de votre fournisseur de réservations.

Le lien permet-il de savoir ce qu'inclut un tarif ?

Non. Un lien général vers la politique d'une compagnie ne détermine pas la franchise de bagages d'une réservation donnée. Utilisez la franchise indiquée par le tarif ou la réservation choisis et proposez le lien comme information complémentaire.

Puis-je obtenir la politique par code IATA, code OACI ou nom ?

Oui. Interrogez un enregistrement de compagnie avec iata, icao ou name et lisez baggage_url. La recherche par nom accepte les correspondances partielles ; confirmez la compagnie renvoyée avant d'utiliser son lien.

Quel lien afficher pour les vols en partage de codes ou avec plusieurs compagnies ?

Rattachez chaque lien à l'enregistrement de la compagnie dont il dépend et libellez-le avec le nom de cette compagnie. Ne décidez pas à partir de ce seul champ des règles applicables à la réservation ; utilisez les informations de bagages de la réservation. Un libellé clair comme « Voir la politique de bagages de la compagnie » indique aux voyageurs ce qui va s'ouvrir.

Que faire si baggage_url est vide ?

N'affichez pas de lien vide ou cassé. Omettez le bouton ou proposez un autre moyen de joindre le service client dans votre application. L'absence de données ne signifie ni que la compagnie autorise ou exclut tel bagage, ni qu'elle n'a pas de politique de bagages.

Puis-je stocker les liens vers les politiques de bagages dans ma propre base de données ?

Oui, avec une licence adaptée de la base de données des compagnies aériennes. Exportez avec dump=1 en JSON, XML ou CSV et conservez l'identifiant de la compagnie avec chaque URL. Mettez régulièrement à jour les enregistrements stockés ; Airhex vérifie et met à jour chaque jour les données des compagnies. Conservez airhex_id et l'horodatage updated de la réponse complète pour que les imports récupèrent les URL modifiées.

L'API renvoie-t-elle le texte de la politique ou des versions traduites ?

Le champ documenté baggage_url renvoie une URL, et non le texte de la politique ni des variantes linguistiques. Le contenu et les langues disponibles dépendent de la page de la compagnie.

Aidez les voyageurs à trouver la politique de bagages de leur compagnie

Placez les liens vers les politiques des compagnies là où les voyageurs en ont besoin : parcours de réservation, itinéraires et outils d'assistance client, sans tenir votre propre répertoire d'URL.

Clé d'API de testDemander un devis →

API compagnies aériennes →

Explorez le jeu de données complet des compagnies aériennes : codes IATA et OACI, noms, statut opérationnel, types de compagnies, alliances, programmes de fidélité, liens vers l'enregistrement en ligne et la politique de bagages, logos et couleurs de marque. Tous les paramètres de requête et champs de réponse, avec consultations unitaires et export complet en JSON, XML et CSV.

API alliances aériennes →

Consultez l'alliance d'une compagnie aérienne par code IATA, code OACI ou nom, créez des filtres par alliance et regroupez les compagnies dans votre application.

API programmes de fidélité →

Consultez le programme de fidélité des compagnies par code IATA, code OACI ou nom, créez des répertoires de programmes et enrichissez vos profils de compagnies.