Aller au contenu
Blog

Comparer des API de voyage : noter les axes, pas les fournisseurs

Rédaction Tekravel
Rédigé avec l’aide de l’IA

Trois présentations de fournisseurs sont ouvertes dans trois onglets. Chacune a sa diapositive avec une longue liste de compagnies aériennes, sa diapositive avec un nombre d'hôtels, un sandbox, du REST et du JSON, une adresse de support. Vous montez un tableau, vous cochez chaque case, et le tableau se termine sur une égalité. C'est la fin habituelle d'une comparaison d'API de voyage menée comme une liste de fonctionnalités, et c'est la mauvaise fin : les différences qui vont décider de votre année n'apparaissent qu'après la mise en production — sur la réservation réussie chez le fournisseur mais tombée en timeout de votre côté, sur le remboursement que personne ne sait traiter, sur la compagnie qui figurait dans la liste mais qu'on ne peut pas émettre par ce canal.

Ce texte s'adresse au développeur ou au lead technique qui doit trancher, puis défendre son choix. Il ne classe pas les fournisseurs. Il propose des axes de comparaison, un plan d'essai qui passe son temps sur les échecs, et quelques questions qui révèlent vite si vous parlez à un fournisseur ou au revendeur du fournisseur de quelqu'un d'autre.

Pourquoi la grille de fonctionnalités finit toujours à égalité

Une grille demande si une capacité existe. Presque toutes les API de voyage répondent oui à presque toutes les lignes, parce que les lignes sont rédigées au niveau de la page marketing : recherche, tarification, réservation, annulation, émission, webhooks, sandbox. Ce qui les distingue, ce n'est pas l'existence de cancel, mais ce qui se passe quand on l'appelle sur une réservation émise, douze heures avant le départ, sur un tarif avec pénalité, via un canal dont le contenu vient d'un tiers. La grille n'a pas de colonne pour ça.

Deuxième problème : c'est généralement le fournisseur qui remplit la grille. Vous notez son autoportrait.

Une comparaison d'API de voyage par axes, pas par fournisseurs

Remplacez la grille fournisseur × fonctionnalité par des axes que vous notez vous-même, à partir de preuves recueillies pendant l'essai. Le tableau ci-dessous est celui que nous utiliserions. Vous pouvez pondérer autrement — une activité purement hôtelière se soucie moins de l'émission — et vous devriez le discuter avant de l'adopter.

AxeCe que demande la grilleCe qu'il faut vraiment savoirÀ quoi ressemble une réponse faible
CouvertureCombien de compagnies et d'hôtels ?Combien peuvent être recherchés, réservés ET émis ou confirmés via cette API, sur vos marchésUn seul grand chiffre, sans ventilation
ProfondeurY a-t-il un endpoint d'annulation ?Quelles opérations après-vente sont automatisées par source de contenu : void, remboursement, réémission, correction de nom, ancillaires« Notre équipe ops s'en charge »
Fiabilité du prixLes prix sont-ils en temps réel ?À quelle fréquence le prix à la réservation diffère du prix à la recherche, et comment l'API vous le signale« Les prix sont toujours en direct »
Sémantique des erreursLes erreurs sont-elles documentées ?Si l'erreur indique l'état de la réservation, et pas seulement qu'un échec a eu lieuUn code générique pour tous les échecs
Idempotence—Si un appel de réservation rejoué peut créer une seconde réservationUn silence, puis « on n'a jamais vu ça »
Fournisseur de référence—Le contrat de qui, le numéro IATA de qui, quel BSP pour le billet« Nous travaillons avec tous les grands GDS »
Accès et supportY a-t-il un sandbox ?Qui répond quand un PNR réel est bloqué, et en combien de tempsUn formulaire de ticket, aucun interlocuteur nommé

Deux de ces lignes n'ont aucune question équivalente dans une grille classique. Ce n'est pas un hasard : ce sont celles qui coûtent le plus cher quand elles déraillent, et celles qu'une présentation commerciale mentionnera le moins spontanément.

La couverture n'est pas la profondeur

La liste des compagnies est la diapositive la plus trompeuse de n'importe quelle présentation. Une liste de plusieurs centaines de transporteurs peut vouloir dire plusieurs choses, et une seule correspond à ce que vous cherchez.

Certains transporteurs passent par un GDS et se réservent et s'émettent de bout en bout. D'autres passent par des connexions NDC, où le shopping peut très bien fonctionner alors que l'après-vente — modification, remboursement partiel, ajout d'un bagage — reste parfois manuelle pour cette compagnie. D'autres encore sont des low-cost dont le contenu est agrégé chez un autre revendeur : vous pouvez les afficher, parfois les réserver, puis le billet arrive par une voie que vous ne maîtrisez pas, dans un délai que vous ne pouvez pas promettre au client. Et certains figurent dans la liste parce qu'un tarif est un jour remonté dans une réponse de recherche.

Un transporteur qu'on peut afficher mais pas émettre n'est pas de la couverture. Pour un produit grand public, c'est pire que son absence : le client le choisit, paie, puis attend.

L'hôtellerie a la même forme avec d'autres mots. Un nombre d'établissements mélange ceux que le fournisseur a mappés et ceux qu'il n'a pas mappés, des tarifs statiques mis en cache la semaine dernière et de la disponibilité en direct, des chambres en allotement avec délai de rétrocession et du stock en free-sale. Demandez le nombre réservable en direct dans les villes que vous vendez, et demandez comment sont fusionnés les doublons entre leurs propres fournisseurs — le même hôtel affiché trois fois à trois prix est un ticket de support qui attend son heure.

Le test pratique est étroit. Notez les vingt routes et les vingt villes hôtelières qui font l'essentiel de votre volume — Paris–Marrakech, Lyon–Dubaï, Bruxelles–Tunis, par exemple — et demandez au fournisseur de montrer précisément celles-là de bout en bout dans le sandbox : recherche, prix, réservation, émission ou confirmation, annulation. Celui qui a la profondeur le fera sans histoire. Celui qui n'a que la diapositive se mettra à parler de la diapositive.

Ce qu'il faut tester pendant l'essai : les chemins d'erreur, pas le scénario nominal

Tous les sandboxes réservent sans problème un aller simple en classe économique sur une route calme. C'est pour ça qu'ils ont été construits. Votre trafic réel passera une part non négligeable de sa vie sur les autres chemins, et l'essai est le seul moment bon marché pour les voir.

Servez-vous de l'essai pour dérouler cette liste, en notant ce que l'API a renvoyé à côté de ce qui était réellement vrai ensuite :

  • Changement de prix entre recherche et réservation. L'appel échoue-t-il, réussit-il au nouveau prix, ou renvoie-t-il une réponse distincte demandant confirmation ? Votre interface sait-elle faire la différence sans analyser un texte de message ?
  • Offre expirée. Recherchez, attendez au-delà de la durée de vie de l'offre, puis réservez. L'expiration est-elle une erreur spécifique, ou la même que « fournisseur indisponible » ?
  • Complet au moment de réserver. Du stock qui disparaît entre tarification et réservation. Dans quel état est la réservation, et l'autorisation de paiement est-elle libérée ?
  • Nouvel essai après timeout. Envoyez une réservation, coupez la connexion avant la réponse, renvoyez-la. Avez-vous un PNR ou deux ? Ce seul test en dit plus sur un fournisseur que tout le reste de l'essai réuni.
  • Réservation créée, émission échouée. L'API sait-elle signaler un PNR existant non émis, et vous donne-t-elle la date limite d'émission ?
  • Échec partiel. Une demande hôtelière multi-chambres où une chambre est confirmée et l'autre non. Un aller-retour dont l'aller et le retour viennent de sources différentes.
  • Annulation hors délai gratuit. La pénalité est-elle annoncée avant confirmation, ou découverte sur la facture ?
  • Panne fournisseur. Demandez comment la simuler. S'ils ne savent pas, demandez comment leurs clients ont appris le comportement.

Dans chaque cas, vous notez deux choses. L'API vous dit-elle la vérité sur l'état de la réservation ? Votre code peut-il agir sur cette vérité sans qu'un humain lise du texte libre ? Une API qui échoue clairement est plus facile à vivre qu'une API qui réussit de façon ambiguë.

Nous avons détaillé le versant aérien dans ce que la documentation des API de réservation de vols ne dit pas, et la conception d'un client pour fournisseurs hôteliers lents dans l'article sur la disponibilité hôtelière. Les deux complètent bien un plan d'essai.

Les questions qui démasquent un agrégateur trop mince

Il n'y a rien de mal à passer par un agrégateur. La plupart du contenu voyage arrive à la plupart des vendeurs par l'un d'eux. Le risque, c'est l'agrégateur mince : une couche qui revend l'API d'une autre couche, ajoute une marge, et ne possède ni le contrat fournisseur ni le desk opérationnel. Quand quelque chose casse, la réponse doit remonter deux sociétés puis redescendre.

Cinq questions le font apparaître vite :

  1. Qui est le fournisseur de référence de cette réservation ? Sur le contrat de qui avec la compagnie ou l'hôtel repose-t-elle ?
  2. Sous quel numéro IATA et quel BSP le billet est-il émis ? Si la réponse est « celui d'un partenaire », demandez qui reçoit l'ADM quand une règle tarifaire est violée.
  3. Quand j'appelle l'annulation, que se passe-t-il chez vous ? Un appel automatique au fournisseur, ou une file qu'une personne traite ?
  4. Puis-je voir l'erreur d'origine ? Une couche mince a tendance à écraser chaque échec en un seul code, parce qu'elle ne comprend pas entièrement les erreurs qu'elle reçoit.
  5. Qui j'appelle pour une réservation réelle bloquée, et qui cette personne appelle-t-elle ? Comptez les intermédiaires.

Aucune de ces réponses n'est éliminatoire à elle seule. Le numéro IATA d'un partenaire peut convenir si le contrat dit clairement qui porte la note de débit. Ce qui compte, c'est que le fournisseur réponde précisément et vite. Les réponses floues ici sont celles que vous obtiendrez plus tard, en production, à une heure plus difficile.

Ce que coûte un mauvais choix

L'intégration est la partie bon marché. Les parties chères arrivent après et ne figurent dans aucune estimation.

Un bug de double réservation, c'est un client débité deux fois et un PNR à retrouver et annuler à la main, peut-être après la fermeture de la fenêtre de void gratuite. Une réservation réussie en amont alors que votre système a enregistré un échec, c'est un siège bloqué puis annulé automatiquement, et un client qui se croit réservé. Un transporteur affiché mais impossible à émettre, c'est un remboursement, des excuses et un client qui ne revient pas. Une ADM pour une règle tarifaire violée par le canal du fournisseur tombe sur le propriétaire du billet — sachez à l'avance si c'est vous.

Reste le coût de sortie. Chaque bizarrerie de fournisseur que vous absorbez — un code de statut qui veut dire deux choses, un champ parfois texte — finit dans votre modèle de données. Deux ans plus tard, le choix de l'API n'est plus une intégration remplaçable en un sprint : c'est la forme de votre table de réservations. Voilà la vraie raison de comparer soigneusement maintenant.

Où se situe notre propre API dans ce cadre

Nous exposons des API aériennes et hôtelières. L'accès commence par une conversation plutôt que par une clé en libre-service, ce que certains développeurs trouvent lent ; la raison, c'est que cette conversation est l'endroit où les questions ci-dessus se posent dans les deux sens — quelles routes et quelles villes il vous faut, quel contenu vous pourrez réellement émettre ou confirmer, qui gère quoi après la réservation. Si vous menez une comparaison, apportez cette liste. La page des API de voyage est le point de départ de cette conversation.

Quel que soit votre choix, faites-le à partir du journal d'essai plutôt que de la présentation. La présentation vous dit ce qu'un fournisseur veut être. Les chemins d'erreur vous disent ce qu'il est.

Rédaction Tekravel

Desk technologies du voyage

Le desk technologies du voyage de Tekravel écrit pour les professionnels : dirigeants d'agences, consolidateurs et développeurs qui les intègrent. Chaque article est vérifié sur la plateforme qu'il décrit avant publication.