API programmes de fidélité

Associez les compagnies aux noms de leurs programmes de fidélité. Obtenez les noms des programmes avec les codes des compagnies pour enrichir les profils de compagnies, constituer des répertoires de programmes de fidélité et donner un contexte utile à votre application de voyage.

Clé d'API de test Voir l'exemple
  • Noms des programmes de fidélité
  • Recherche par code ou par nom
  • JSON, XML et CSV

Rechercher le programme de fidélité d'une compagnie aérienne

Interrogez United Airlines avec le code IATA UA et lisez ffp_name. L'exemple renvoie MileagePlus. 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",
    "ffp_name": "MileagePlus",
    ...
  }
]

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 ffp_name dans les enregistrements renvoyés. Le paramètre name cherche dans les noms de compagnies, et non dans les noms des programmes de fidélité. Filtrez les noms de programmes dans votre application une fois les enregistrements récupérés.

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

Affichez avec ffp_name le programme associé à l'enregistrement de la compagnie. Conservez l'identifiant de la compagnie avec le nom du programme lorsque vous constituez ou mettez à jour un répertoire local.

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.
ffp_name StringMileagePlusNom du programme de fidélité de la compagnie.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger les noms des programmes de fidélité

Exportez le répertoire en CSV et conservez ffp_name avec les noms des compagnies, les codes et airhex_id. Constituez un répertoire avec les noms de programmes renseignés. Définissez onlyscheduled=0 si vous avez besoin de types de compagnies autres que régulières, puis choisissez les enregistrements pertinents pour votre application.

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-frequent-flyer-programs.csv

Trouver le programme par nom de compagnie

Cherchez avec le nom de la compagnie, choisissez l'enregistrement voulu et lisez ffp_name. La recherche par nom accepte les correspondances partielles et peut renvoyer plusieurs compagnies : confirmez la compagnie avant d'afficher un programme. Pour chercher par nom de programme, filtrez en local le répertoire téléchargé.

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

Obtenir le nom du programme avec un code OACI

Utilisez icao lorsque votre source fournit un code de compagnie à trois lettres. L'exemple interroge United Airlines avec UAL et lit le nom du programme de fidélité 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

Profils de compagnies plus riches

Affichez le programme de fidélité enregistré à côté du nom de la compagnie et des autres informations de référence.

Répertoires de programmes de fidélité

Constituez un répertoire facile à consulter, qui relie les noms et les codes des compagnies à leurs programmes de fidélité enregistrés.

Contexte pour les équipes d'assistance voyageurs

Donnez aux conseillers, lorsqu'ils examinent une réservation, le nom du programme de la compagnie et rattachez les questions sur le compte et les avantages au programme concerné.

Questions fréquentes

Que renvoie l'API programmes de fidélité ?

Le champ ffp_name renvoie le nom du programme de fidélité de la compagnie. Il figure dans l'enregistrement de l'API compagnies aériennes, avec les noms des compagnies, les codes et d'autres données de référence.

Puis-je interroger un programme avec un code de compagnie ?

Oui. Envoyez un code IATA dans iata ou un code OACI dans icao et lisez ffp_name. Vous pouvez aussi chercher par nom de compagnie.

Puis-je chercher directement par nom de programme de fidélité ?

Le paramètre documenté name cherche dans les noms de compagnies, et non dans ceux des programmes. Exportez le répertoire avec dump=1 et cherchez ou filtrez ffp_name en local si votre application a besoin d'une recherche par nom de programme.

L'API renvoie-t-elle des soldes de miles ou vérifie-t-elle des numéros d'adhérent ?

Non. ffp_name fait partie des données de référence de la compagnie. L'API ne fournit ni comptes de passagers, ni soldes de miles, ni vérification d'adhésion, ni accès à un compte de fidélité.

ffp_name permet-il de savoir dans quel programme un passager peut cumuler des miles pour un vol ?

Non. Le champ indique le programme figurant dans l'enregistrement de la compagnie, et non tous les programmes partenaires acceptés pour une réservation donnée. Le cumul de miles et l'éligibilité dépendent des règles du tarif et du programme. Le nom seul ne dit rien des quantités de miles ni des avantages pour les passagers.

Le nom d'un programme est-il un identifiant unique ?

La documentation de l'API ne définit pas ffp_name comme identifiant unique du programme. Enregistrez le rattachement à la compagnie avec airhex_id et ses codes, et n'utilisez pas le nom affiché comme clé permanente de l'enregistrement.

Que faire si ffp_name est vide ?

Omettez l'étiquette du programme ou affichez « Aucun programme enregistré », selon la conception de votre produit. Une valeur vide ne permet pas de savoir si la compagnie participe à d'autres accords de fidélité. Ne déduisez pas un programme à partir de l'alliance ni de la compagnie mère.

Puis-je télécharger les noms de programmes et les stocker 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 les noms de programmes. Mettez régulièrement à jour les enregistrements stockés ; 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 de noms de programmes.

Aidez les voyageurs à reconnaître les programmes de fidélité des compagnies

Affichez les noms des programmes de fidélité à côté des informations sur les compagnies et donnez aux voyageurs et aux équipes d'assistance un contexte utile, sans tenir votre propre répertoire de programmes.

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.