API codes OACI des compagnies aériennes

Identifiez les compagnies par les codes OACI à trois lettres présents dans vos données aéronautiques. Obtenez les noms des compagnies et les codes IATA correspondants, ou téléchargez le répertoire pour rapprocher des enregistrements dans votre propre application.

Clé d'API de test Voir l'exemple
  • Recherche par code ou par nom
  • JSON, XML et CSV
  • Consultation unitaire ou export complet

Rechercher une compagnie aérienne par son code OACI

Envoyez le code de compagnie à trois lettres dans le paramètre icao de l'API compagnies aériennes. Cet exemple interroge Southwest Airlines avec SWA. 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 'icao=SWA'

Réponse · extrait JSON

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

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

Utilisez ces paramètres de requête pour rechercher des codes de compagnies ou exporter le répertoire.

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

Identifiez une compagnie avec icao et rapprochez-la des données de votre système de réservation au moyen de iata, s'il existe un code IATA. Les champs suivants respectent l'ordre de la référence principale de l'API.

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.
status Integer1Statut opérationnel : 1 = active, 0 = inactive, 2 = en démarrage.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger le répertoire des codes de compagnies

Avec dump=1, la base de données est exportée. Ajoutez onlyscheduled=0 pour inclure tous les types de compagnies au lieu du filtre par défaut, qui ne retient que les compagnies régulières. L'exemple en CSV peut être importé dans votre propre base de données ; si vous constituez une table de correspondance OACI, conservez les enregistrements dont le champ icao est renseigné. Examinez type_code si vous voulez exclure d'autres types d'exploitants, comme le train, le bus et le ferry.

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

Trouver le code OACI par nom de compagnie

Cherchez avec name et lisez icao dans chaque enregistrement renvoyé. La recherche par nom accepte les correspondances partielles : examinez les compagnies renvoyées au lieu de considérer le premier résultat comme le seul.

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

Rapprocher un code IATA d'un code OACI

Envoyez le code IATA dans iata et lisez le champ icao de la réponse. Vous obtenez ainsi, à partir de WN transmis par un fournisseur de réservations, le code SWA à rapprocher d'un jeu de données aéronautiques.

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

Ce que vous pouvez créer

Enrichir les données aéronautiques

Transformez les codes OACI de compagnies d'un jeu de données aéronautiques en noms lisibles pour les tableaux de bord et les rapports.

Relier données de réservation et données aéronautiques

Rapprochez les identifiants IATA des fournisseurs de réservations des identifiants OACI d'autres sources et vérifiez que les deux enregistrements désignent la même compagnie.

Répertoires d'exploitants

Constituez une table de correspondance locale des compagnies pour les exploitants réguliers, de fret ou charter, avec des filtres explicites de type et de statut opérationnel.

Questions fréquentes

Qu'est-ce que le code OACI d'une compagnie aérienne ?

Un code de compagnie à trois lettres, par exemple SWA pour Southwest Airlines. Cette page traite des identifiants de compagnies ; pour les identifiants d'aéroports, utilisez l'API aéroports.

Quelle différence entre les codes OACI et IATA des compagnies ?

Les codes OACI des compagnies comptent trois lettres ; les codes IATA, deux caractères, et peuvent inclure des chiffres. L'API compagnies aériennes renvoie les deux champs lorsqu'ils existent. Utilisez le paramètre qui correspond au système de codes de votre source de données : envoyez les codes OACI dans icao et les codes IATA dans iata.

Puis-je convertir des codes OACI de compagnies en codes IATA, et inversement ?

Interrogez un code OACI avec icao et lisez iata dans le résultat, ou interrogez un code IATA avec iata et lisez icao. Avant de les rapprocher, vérifiez que le champ cible est renseigné ; tous les enregistrements n'ont pas les deux codes. Conservez le code OACI et l'identité de la compagnie même s'il n'existe aucun équivalent IATA.

Puis-je interroger les exploitants de fret et de charter ?

Définissez onlyscheduled=0 pour inclure des types de compagnies au-delà du filtre par défaut des compagnies régulières. Choisissez les catégories d'exploitants voulues avec type_code et, si votre application ne doit afficher que des compagnies actives, avec status. La valeur par défaut onlyscheduled=1 ne retient que les compagnies régulières.

parent_icao indique-t-il la compagnie exploitante d'un vol ?

Non. Selon la référence de l'API compagnies aériennes, parent_icao est le code OACI d'une compagnie mère, le cas échéant. Pour identifier la compagnie exploitante d'un vol donné, utilisez l'identifiant fourni par votre fournisseur de vols et interrogez cette compagnie séparément.

Comment traiter une recherche sans résultat ?

Conservez le code d'origine de votre source comme solution de repli lorsqu'une compagnie ne peut pas être résolue, et distinguez les requêtes en échec de l'absence de résultats. En cas de correspondances partielles dans la recherche par nom, comparez les noms et les codes avant de choisir un enregistrement.

Puis-je tenir un répertoire OACI des compagnies 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 les champs dont votre intégration a besoin. Stockez airhex_id avec les rapprochements de codes et mettez régulièrement à jour votre copie. Airhex vérifie et met à jour chaque jour les données des compagnies ; l'API modifications renvoie les changements les plus récents. Lors de la mise à jour, conservez l'horodatage updated de la réponse complète.

Cet endpoint offre-t-il le suivi de vols ou le statut des vols en temps réel ?

Non. Il fournit des données de référence sur les compagnies pour les identifier et rapprocher des codes. Les informations de vols en temps réel viennent de votre fournisseur de données de vols. Le champ status décrit ici le statut opérationnel de la compagnie, et non celui d'un vol donné.

Créez votre recherche de codes OACI de compagnies

Rapprochez les identifiants de compagnies entre sources de données aéronautiques et gardez cohérents les noms des compagnies dans les tableaux de bord, les rapports et les outils destinés aux passagers.

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.