API enregistrement en ligne des compagnies aériennes

Aidez les voyageurs à accéder directement à l'enregistrement en ligne de leur compagnie depuis l'itinéraire ou un message précédant le voyage. Obtenez les URL d'enregistrement, associées aux codes et aux noms des compagnies et prêtes pour votre application de voyage.

Clé d'API de test Voir l'exemple
  • Liens vers l'enregistrement en ligne
  • Recherche par code ou par nom
  • JSON, XML et CSV

Obtenir les liens vers l'enregistrement en ligne d'une compagnie aérienne

Interrogez Southwest Airlines avec le code IATA WN et lisez web_checkin_url. Dirigez les voyageurs vers la page d'enregistrement de la compagnie avec l'une des URL renvoyées. 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",
    "web_checkin_url": "https://www.southwest.com/air/check-in/?clk=HP-CHKIN",
    ...
  }
]

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

Avec l'API compagnies aériennes, vous interrogez une compagnie ou exportez le répertoire. web_checkin_url est un champ de la réponse. La requête identifie la compagnie ; elle n'envoie pas la réservation d'un passager vers l'enregistrement.

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

Rattachez web_checkin_url à la compagnie avant d'afficher le lien. Le champ renvoie vers la page d'enregistrement de la compagnie ; il ne contient ni le statut d'enregistrement d'un passager ni une carte d'embarquement.

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.
web_checkin_url String (URL)https://www.southwest.com/air/check-in/?clk=HP-CHKINURL de l'enregistrement web du passager.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger les liens d'enregistrement de votre répertoire de compagnies

Exportez le répertoire en CSV et conservez web_checkin_url avec les noms des compagnies, les codes et airhex_id. Vérifiez qu'une URL est renseignée avant d'afficher un bouton d'enregistrement. Utilisez onlyscheduled=0 si vous avez besoin de types de compagnies autres que régulières, et choisissez les enregistrements adaptés dans 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-check-in-links.csv

Trouver les liens d'enregistrement par nom de compagnie

Cherchez avec name, confirmez la compagnie voulue et lisez web_checkin_url. La recherche par nom accepte les correspondances partielles. Examinez les compagnies renvoyées avant de rattacher un lien à un itinéraire.

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

Obtenir les liens d'enregistrement avec un code OACI

Utilisez icao lorsque votre source fournit un code OACI à trois lettres de la compagnie. L'exemple interroge Southwest Airlines avec SWA et renvoie le même champ web_checkin_url.

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

Ce que vous pouvez créer

Boutons d'enregistrement dans les itinéraires

Proposez aux voyageurs, dans votre écran de gestion des voyages, un lien clairement libellé vers la page d'enregistrement de leur compagnie.

Rappels d'enregistrement avant le voyage

Intégrez les liens d'enregistrement des compagnies dans vos rappels et ajustez le moment d'envoi en fonction de vos données de réservation ou de compagnies.

Aide à l'enregistrement pour les équipes d'assistance

Permettez aux conseillers d'obtenir les liens vers l'enregistrement en ligne de la compagnie à partir du code de compagnie d'une réservation.

Questions fréquentes

Que renvoie l'API enregistrement en ligne des compagnies aériennes ?

L'API compagnies aériennes renvoie web_checkin_url avec l'identifiant de la compagnie. Le champ contient un lien vers la page d'enregistrement en ligne destinée aux passagers.

L'API enregistre-t-elle les passagers ou émet-elle des cartes d'embarquement ?

Non. Elle fournit les URL d'enregistrement des compagnies. Le passager s'enregistre auprès de la compagnie, qui vérifie la réservation, enregistre les données du passager et émet la carte d'embarquement.

La réponse indique-t-elle quand l'enregistrement ouvre ?

Non. Le champ documenté renvoie une URL, et non les horaires d'ouverture d'un vol donné ni des informations sur l'éligibilité du passager. Le moment où l'enregistrement est possible figure dans les informations de la compagnie ou dans les données de réservation correspondantes. Fondez vos rappels et vos notifications sur ce délai d'enregistrement, et non sur l'existence d'une URL.

Puis-je préremplir le code de réservation et le nom du passager ?

L'API documentée renvoie des URL d'enregistrement et ne définit aucun paramètre pour préremplir les données des passagers. Ne supposez pas que vous pouvez ajouter des données de réservation à une URL renvoyée. Utilisez la méthode d'intégration documentée d'une compagnie, si elle en propose une.

Quel lien d'enregistrement afficher pour les vols en partage de codes ?

Déterminez à partir des informations d'enregistrement de la réservation quelle compagnie est responsable, puis interrogez-la. L'API de référence ne détermine pas qui est responsable de l'enregistrement d'un voyage donné.

Que faire si web_checkin_url est absent ?

Omettez le bouton d'enregistrement ou proposez un autre moyen de joindre le service client. Une URL absente ne signifie pas que l'enregistrement en ligne est indisponible pour la réservation du passager.

Puis-je stocker les liens d'enregistrement dans ma propre base de données ?

Oui, avec une licence adaptée de la base de données des compagnies aériennes. Exportez le répertoire en JSON, XML ou CSV et conservez l'identifiant de la compagnie avec chaque URL. Mettez régulièrement à jour votre copie ; 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 d'URL.

Comment afficher un lien d'enregistrement ?

Utilisez la valeur de web_checkin_url, si elle existe, comme destination d'un bouton d'enregistrement clairement libellé. Indiquez le nom de la compagnie pour que les voyageurs sachent quelle page va s'ouvrir.

Facilitez l'accès à l'enregistrement des compagnies

Offrez aux voyageurs un accès direct, depuis leur itinéraire ou un rappel, à la page d'enregistrement en ligne de leur compagnie, avec des liens tenus à jour et rattachés aux codes de compagnies.

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.