API alliances aériennes

Aidez les voyageurs à trouver les compagnies de leur alliance aérienne préférée. Obtenez l'appartenance à une alliance avec les noms et les codes des compagnies pour intégrer à votre application de voyage des étiquettes d'alliance, des filtres et des comparaisons de compagnies.

Clé d'API de test Voir l'exemple
  • Appartenance à une alliance
  • Recherche par code ou par nom
  • JSON, XML et CSV

Rechercher l'alliance d'une compagnie aérienne

Interrogez United Airlines avec le code IATA UA et lisez alliance. L'exemple renvoie Star Alliance. 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=UA'

Réponse · extrait JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "alliance": "Star Alliance",
    ...
  }
]

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

Interrogez une compagnie ou exportez le répertoire, puis lisez alliance dans les enregistrements renvoyés. L'endpoint documenté n'a pas de paramètre de requête alliance : regroupez ou filtrez les enregistrements dans votre application.

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 UA.
icao ConditionnelAucunRecherche d'une compagnie par son code OACI à trois lettres, par exemple UAL.
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

Utilisez alliance pour afficher l'appartenance à une alliance à côté du nom et des codes de la compagnie. Conservez status si vous constituez un répertoire de membres actifs, et airhex_id pour mettre à jour vos enregistrements locaux.

ChampTypeExempleDescription
airhex_id String965Identifiant permanent de l'enregistrement chez Airhex. Utilisez-le pour rattacher les futures mises à jour au même enregistrement.
iata StringUACode IATA à deux caractères de la compagnie. Les codes peuvent contenir des lettres et des chiffres ; stockez-les sous forme de texte.
icao StringUALCode OACI à trois lettres de la compagnie, utile pour passer d'un système de codes à un autre.
marketing_name StringUnited AirlinesNom commercial de la compagnie à afficher dans votre application.
status Integer1Statut opérationnel : 1 = active, 0 = inactive, 2 = en démarrage.
alliance StringStar AllianceAlliance dont la compagnie est membre, le cas échéant.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger le répertoire et regrouper les compagnies par alliance

Exportez le répertoire en CSV et regroupez les enregistrements dans votre application selon le champ alliance. Filtrez sur le nom d'alliance renvoyé pour constituer une liste de membres, et examinez status si vous ne voulez afficher que des compagnies actives. onlyscheduled=0 élargit les types de compagnies couverts ; choisissez les enregistrements adaptés avec type_code.

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-alliances.csv

Trouver l'alliance d'une compagnie par son nom

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

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

Obtenir l'alliance avec un code OACI

Utilisez icao lorsque votre source fournit un code OACI à trois lettres de la compagnie. L'exemple interroge United Airlines avec UAL et lit alliance dans le même enregistrement.

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

Ce que vous pouvez créer

Filtres par alliance dans la recherche de vols

Rapprochez les codes de compagnies de vos fournisseurs de votre répertoire et laissez les voyageurs restreindre les résultats par alliance aérienne, en traitant clairement les compagnies commerciale et exploitante.

Pages de comparaison de compagnies

Affichez l'alliance enregistrée à côté du nom de chaque compagnie pour que les voyageurs comparent plus facilement les compagnies.

Répertoires des membres d'alliances

Regroupez les enregistrements de compagnies par appartenance et constituez des listes de consultation et des rapports internes.

Questions fréquentes

Que renvoie l'API alliances aériennes ?

Le champ alliance indique l'alliance dont une compagnie est membre, le cas échéant. Il fait partie de l'enregistrement de l'API compagnies aériennes, avec les noms, les codes IATA, les codes OACI et d'autres données de référence.

Puis-je obtenir toutes les compagnies d'une alliance donnée ?

Exportez le répertoire avec dump=1 et filtrez dans votre application sur les valeurs de alliance renvoyées. L'endpoint documenté n'a pas de paramètre de requête pour l'alliance. Examinez status si votre liste de membres ne doit contenir que des compagnies actives. Formez des groupes à partir des valeurs de alliance renseignées et conservez noms et codes dans chaque enregistrement pour rapprocher les compagnies dans les résultats de recherche.

Puis-je interroger l'appartenance par code IATA, code OACI ou nom ?

Oui. Récupérez les enregistrements de compagnies avec iata, icao ou name et lisez alliance. La recherche par nom accepte les correspondances partielles ; choisissez la compagnie voulue avant d'utiliser le résultat.

Que faut-il afficher si alliance est vide ?

Omettez l'étiquette d'alliance ou affichez « Aucune alliance enregistrée », selon la conception de votre produit. Ne déduisez pas une appartenance à partir d'une compagnie mère, d'un partenaire de partage de codes ou d'un nom de compagnie semblable.

L'appartenance à une alliance signifie-t-elle que les passagers cumulent des miles ou accèdent aux salons ?

Non. Le champ décrit l'appartenance de la compagnie et ne détermine pas les avantages d'un passager ou d'une réservation donnés. L'éligibilité dépend des règles du programme de fidélité concerné et des données de la réservation.

Comment les filtres par alliance doivent-ils traiter les vols en partage de codes ?

Décidez si votre filtre s'applique à la compagnie commerciale, à la compagnie exploitante ou aux deux, et expliquez-le aux voyageurs. Interrogez séparément chaque compagnie figurant dans l'itinéraire ; le champ alliance ne détermine pas les relations de partage de codes d'un vol.

Puis-je stocker l'appartenance aux alliances dans ma propre base de données ?

Oui, avec une licence adaptée de la base de données des compagnies aériennes. Exportez en JSON, XML ou CSV et conservez l'identifiant de la compagnie avec la valeur de alliance. Mettez régulièrement à jour votre répertoire ; 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 détecter les changements d'appartenance et de statut des compagnies.

L'API renvoie-t-elle les appartenances passées à des alliances ?

Le champ documenté alliance indique l'alliance figurant dans l'enregistrement de la compagnie. Il n'y a ni périodes d'appartenance ni consultation à une date donnée. Constituez vos propres instantanés datés si vos rapports ont besoin de comparaisons historiques.

Aidez les voyageurs à trouver les compagnies de leur alliance préférée

Intégrez à votre produit de voyage des filtres par alliance et des étiquettes d'appartenance, sans tenir vous-même à jour les listes des compagnies membres.

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 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.