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 de codes, ne conservez que les enregistrements avec un code IATA.
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 IATA par nom de compagnie
Cherchez avec name et lisez iata 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 OACI d'un code IATA
Envoyez le code OACI dans icao et lisez le champ iata de la réponse. Vous rapprochez ainsi les identifiants de compagnies issus de différentes sources de données.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=SWA'
Questions fréquentes
Quelle différence entre les codes IATA de compagnies, les codes d'aéroports et les codes OACI ?
Un code IATA de compagnie compte deux caractères, par exemple WN pour Southwest Airlines, et peut inclure des chiffres. Les codes IATA d'aéroports identifient des lieux et comptent trois lettres. Les codes OACI de compagnies forment un système distinct à trois lettres ; le code OACI de Southwest est SWA.
Puis-je rapprocher les compagnies de mon fournisseur de réservations de vols ?
Si votre fournisseur transmet un code IATA, envoyez-le dans le paramètre iata pour obtenir le nom et les données de référence associés. S'il transmet des codes OACI, utilisez icao. Avant de rapprocher, vérifiez quel système de codes utilise chaque champ du fournisseur.
Comment traiter les compagnies commerciale et exploitante ?
Utilisez les identifiants de la compagnie commerciale et de la compagnie exploitante du vol et interrogez-les séparément. Vous pouvez ensuite afficher la compagnie commerciale et ajouter, si nécessaire, « opéré par ». Cet endpoint de référence ne détermine pas quelle compagnie exploite un vol donné.
Tous les enregistrements de compagnies ont-ils un code IATA ?
Ne partez pas du principe que chaque enregistrement a un code IATA. Vérifiez que le champ iata est renseigné avant d'inclure un enregistrement dans votre table de correspondance IATA. Utilisez airhex_id comme clé permanente dans votre répertoire local, et non le code de la compagnie.
Comment mon intégration doit-elle traiter les résultats absents ou ambigus ?
Distinguez les requêtes en échec des recherches sans compagnie correspondante. Affichez le code d'origine du fournisseur comme solution de repli s'il ne peut pas être résolu. La recherche par nom accepte les correspondances partielles : comparez les noms et les codes renvoyés plutôt que de retenir automatiquement le premier enregistrement.
Puis-je télécharger le répertoire et le stocker dans ma propre base de données ?
Oui, avec une licence adaptée de la base de données des compagnies aériennes. Avec dump=1, vous exportez le répertoire en JSON, XML ou CSV ; définissez onlyscheduled=0 si vous avez besoin de tous les types de compagnies. Avec une copie locale, vous résolvez les noms de compagnies sans envoyer de requête à l'API pour chaque résultat de vol. Faites confirmer les droits d'usage de votre intégration lorsque vous demandez l'accès.
Comment garder à jour les codes de compagnies ?
Airhex vérifie et met à jour chaque jour les données des compagnies. Mettez régulièrement à jour votre répertoire local et conservez airhex_id et updated lors de l'import. L'API modifications renvoie les changements les plus récents ; elle permet de suivre les modifications et de récupérer les enregistrements à jour de l'API compagnies aériennes. Pour planifier votre processus de mise à jour, consultez la référence complète de l'API compagnies aériennes et la documentation de l'API modifications.
L'API inclut-elle la disponibilité des vols, les prix ou le statut des vols ?
Non. Cet endpoint fournit des données de référence pour identifier et afficher les compagnies. La disponibilité, les prix et le statut de chaque vol viennent de votre fournisseur de vols. Le champ status décrit ici le statut opérationnel de la compagnie, et non le statut d'un vol.
Quels types de compagnies faut-il inclure ?
Par défaut, le filtre onlyscheduled=1 ne retient que les compagnies régulières. Avec onlyscheduled=0, vous obtenez tous les types de compagnies. Examinez status si votre application ne doit afficher que des compagnies actives.