API statut des compagnies aériennes

Vérifiez si une compagnie est active, inactive ou encore en démarrage. Obtenez le statut opérationnel avec les codes et les noms des compagnies pour tenir votre répertoire à jour et constituer des listes de sélection de compagnies adaptées.

Clé d'API de test Voir l'exemple
  • Active, inactive, en démarrage
  • Recherche par code ou par nom
  • JSON, XML et CSV

Vérifier le statut opérationnel d'une compagnie aérienne

Interrogez Southwest Airlines avec le code IATA WN et lisez le champ status. La valeur 1 signifie que la compagnie est active. 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",
    "status": 1,
    ...
  }
]

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 téléchargez le répertoire, puis lisez le champ status de la réponse. L'endpoint documenté n'a pas de paramètre de requête status ; appliquez les filtres de statut 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 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

Lisez status avec l'identité de la compagnie. Les valeurs sont 1 pour active, 0 pour inactive et 2 pour une compagnie en démarrage qui n'a pas encore commencé ses opérations. Conservez airhex_id lorsque vous tenez vos enregistrements locaux à jour.

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 (n'a pas encore commencé ses opérations).

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger le répertoire et filtrer par statut

Exportez le répertoire en CSV et filtrez la colonne status dans votre application : 1 pour les compagnies actives, 0 pour les inactives, 2 pour les compagnies en démarrage. onlyscheduled=0 élargit les types de compagnies couverts ; ce n'est pas un filtre de compagnies actives. Examinez type_code si vous voulez exclure les enregistrements de train, de bus ou de 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 airline-status.csv

Trouver le statut d'une compagnie par son nom

Cherchez avec name, choisissez parmi les résultats la compagnie voulue et lisez status. La recherche par nom peut renvoyer plusieurs compagnies. Ajoutez onlyscheduled=0 si vous voulez chercher au-delà des compagnies régulières.

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

Vérifier le statut 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. Lisez la valeur status renvoyée plutôt que de déduire le statut opérationnel de la simple existence d'un code.

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

Ce que vous pouvez créer

Vérifier les compagnies actives dans les outils de réservation

Constituez une liste de sélection avec les enregistrements dont status vaut 1 et appliquez les filtres de type dont votre produit a besoin.

Rapports sur les voyages passés

Conservez les identifiants des compagnies inactives pour expliquer les réservations, itinéraires et transactions passés.

Maintenance du répertoire

Comparez les enregistrements mis à jour grâce à airhex_id et signalez les changements de statut pour examen dans vos outils internes.

Questions fréquentes

Que signifient les valeurs de statut ?

1 signifie active, 0 inactive et 2 une compagnie en démarrage qui n'a pas encore commencé ses opérations. Les valeurs décrivent la compagnie en tant qu'entreprise.

« Active » signifie-t-il qu'un vol est réservable ?

Non. Le statut « active » ne dit rien de la disponibilité sur une ligne ou à une date. La disponibilité des vols et les prix viennent de votre fournisseur de réservations.

Puis-je interroger uniquement les compagnies actives ?

L'API compagnies aériennes documentée n'a pas de paramètre de requête status. Récupérez les enregistrements dont vous avez besoin et filtrez dans votre application sur status égal à 1. onlyscheduled=1 retient les types de compagnies régulières ; cela ne remplace pas la vérification du statut. Comparez explicitement à 1 : un test « différent de zéro » inclurait aussi les compagnies en démarrage dont status vaut 2.

Comment trouver les compagnies inactives ou en démarrage ?

Exportez le répertoire et filtrez les enregistrements sur status 0 ou 2. Définissez onlyscheduled=0 si vous avez besoin de tous les types d'exploitants. Pour une compagnie précise, interrogez le code ou le nom et examinez le status renvoyé.

L'absence d'un code de compagnie signifie-t-elle qu'elle a cessé ses activités ?

Non. L'absence d'un code ou une recherche sans résultat n'est pas un statut opérationnel. Conservez l'identifiant d'origine et examinez le résultat plutôt que de marquer la compagnie comme inactive. N'attribuez un statut opérationnel que si un enregistrement renvoyé contient une valeur de statut connue.

Dois-je supprimer les compagnies inactives de ma base de données ?

Conservez les enregistrements dont vous avez besoin pour les réservations ou les rapports historiques. Vous pouvez exclure les enregistrements dont status vaut 0 des listes de sélection actuelles sans effacer leur identifiant historique. Avec airhex_id, vous rattachez les imports futurs aux enregistrements existants.

Comment tenir à jour le statut des compagnies ?

Airhex vérifie et met à jour chaque jour les données des compagnies. Mettez régulièrement à jour vos enregistrements locaux et conservez airhex_id et l'horodatage updated de la réponse complète. L'API modifications renvoie les changements les plus récents, y compris les changements de statut, pour que vous puissiez les suivre.

S'agit-il d'une API de statut des vols en temps réel ?

Non. Elle fournit le statut opérationnel des compagnies, et non les départs, les arrivées, les retards ni les annulations. Le statut de chaque vol vient d'un fournisseur de données de vols.

Gardez votre répertoire de compagnies à jour

Gardez visibles les compagnies actives dans les listes de sélection actuelles et conservez les identifiants des compagnies inactives pour les réservations et les rapports historiques.

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.