Paramètres de la requête
Interrogez une compagnie ou exportez le répertoire, puis lisez lowcost, type et type_code. Le paramètre onlyscheduled contrôle les types couverts. L'endpoint documenté n'a pas de paramètres de requête lowcost ni type_code ; appliquez ces filtres dans votre application aux enregistrements renvoyés.
| Paramètre | Obligatoire | Par défaut | Description |
|---|
apikey |
Oui | Aucun | Votre clé d'API. Obtenir une clé d'API de test gratuite. |
|---|
iata |
Conditionnel | Aucun | Recherche d'une compagnie par son code IATA à deux caractères, par exemple UA. |
|---|
icao |
Conditionnel | Aucun | Recherche d'une compagnie par son code OACI à trois lettres, par exemple UAL. |
|---|
name |
Conditionnel | Aucun | Recherche de codes de compagnies par nom complet ou partiel de la compagnie. |
|---|
dump |
Conditionnel | 0 | Avec 1, exporte le jeu de données complet, selon le filtre onlyscheduled. |
|---|
response_type |
Non | JSON | Format de la réponse : JSON, XML ou CSV. CSV lance le téléchargement d'un fichier. |
|---|
onlyscheduled |
Non | 1 | Avec 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 →
Tâches d'intégration courantes
Télécharger les classifications et les filtrer
Exportez avec dump=1 et onlyscheduled=0 pour inclure aussi les catégories autres que les compagnies régulières. Dans votre application, retenez lowcost égal à 1 pour les compagnies low cost ou un type_code comme 2 pour les charters passagers ou 8 pour le fret. Normalisez les chaînes numériques avant de comparer des valeurs et gardez la classification low cost distincte du type de compagnie.
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-metadata.csv
Trouver les métadonnées par nom de compagnie
Cherchez avec name, confirmez la compagnie voulue et lisez ses champs de classification. Avec onlyscheduled=0, la recherche porte au-delà des compagnies régulières. La recherche par nom accepte les correspondances partielles et peut renvoyer plusieurs enregistrements. Examinez les compagnies renvoyées avant d'appliquer des étiquettes.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=United' \
--data-urlencode 'onlyscheduled=0'
Obtenir les classifications avec un code OACI
Utilisez icao lorsque votre source fournit un code de compagnie à trois lettres. L'exemple interroge United Airlines avec UAL. Ajoutez onlyscheduled=0 si votre recherche doit aussi couvrir d'autres types d'exploitants.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=UAL' \
--data-urlencode 'onlyscheduled=0'
Questions fréquentes
Que renvoie l'API métadonnées des compagnies aériennes ?
Cette page porte sur lowcost, type et type_code dans la réponse de l'API compagnies aériennes. Ces champs contiennent l'indicateur low cost, le libellé de catégorie et le code de catégorie correspondant, avec les noms et les identifiants des compagnies.
Que signifient les valeurs de lowcost ?
1 indique une compagnie low cost. 0 signifie que l'enregistrement n'est pas marqué comme low cost. C'est une classification de la compagnie qui ne dit rien du prix ni des prestations d'un tarif donné. La franchise de bagages et les prestations incluses viennent des données tarifaires de votre fournisseur de réservations.
Une compagnie peut-elle être à la fois régulière et low cost ?
Oui. Régulière est une catégorie de compagnie ; lowcost est un indicateur indépendant. Utilisez les deux champs si votre application a besoin de compagnies low cost régulières : la catégorie avec type_code et la classification low cost avec lowcost.
Quels types de compagnies existe-t-il ?
Les codes documentés sont 1 Régulière, 2 Charter passagers, 3 Train/bus/ferry, 4 Charter d'hélicoptères, 5 Charter de jets, 6 Vols touristiques, 7 ACMI, 8 Fret et 9 Autres. Utilisez type_code pour les filtres de catégorie et type pour le libellé fourni.
Comment obtenir les exploitants charter ou de fret ?
Définissez onlyscheduled=0 pour inclure les types autres que les compagnies régulières. Pour un répertoire, exportez avec dump=1 et filtrez en local sur type_code 2 pour les charters passagers ou 8 pour le fret. Les charters d'hélicoptères et de jets ont leurs propres codes, 4 et 5.
Puis-je envoyer lowcost ou type_code comme paramètre de requête ?
Ce sont des champs de la réponse, et non des filtres de requête documentés. Récupérez les enregistrements dont vous avez besoin et filtrez dans votre application. Le paramètre de requête documenté est onlyscheduled, pour ne couvrir que les compagnies régulières ou un périmètre de types plus large. La valeur par défaut est 1. Indiquez 0 pour une couverture plus large, puis choisissez explicitement les catégories de compagnies si votre répertoire doit exclure les enregistrements de train, de bus et de ferry.
onlyscheduled=1 signifie-t-il que la compagnie est active ?
Non. La catégorie de compagnie et le statut opérationnel sont des caractéristiques indépendantes. Lisez le champ status si vous devez distinguer les compagnies actives, inactives et en démarrage.
Puis-je stocker les métadonnées 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 en JSON, XML ou CSV et conservez airhex_id avec les classifications. Mettez régulièrement à jour vos enregistrements locaux ; Airhex vérifie et met à jour chaque jour les données des compagnies.
Comment traiter les indicateurs numériques et les valeurs absentes ?
Normalisez les chaînes numériques avant de comparer lowcost à 0 ou 1. Traitez les valeurs absentes ou inattendues comme inconnues plutôt que de leur attribuer une étiquette sans le signaler.