Aller au contenu
Blog

API des prix de vols : le chiffre affiché n'est pas encore un tarif

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

La démo fonctionne. Un développeur branche une API des prix de vols sur un calendrier des jours les moins chers, la grille se remplit, tout le monde est content. Puis le premier vrai client choisit une date, voit un montant plus bas sur la page de résultats que sur la page de paiement, et écrit au support avec une capture d'écran. Rien n'est cassé. L'API a fait ce qu'on lui demandait : elle a répondu à une question sur le prix, et le site a pris la réponse pour une promesse.

Un prix est une offre à la mémoire courte

Un tarif aérien n'est pas une étiquette fixe collée sur un siège. C'est une classe qui s'ouvre et se ferme à mesure que les sièges se vendent, et son montant varie avec la composition des passagers, les vols exacts, les taxes des aéroports concernés et la devise du devis. Une réponse de prix est un instantané pris à un moment donné pour un jeu d'entrées donné. Traitez-la comme un fait du passé et vous construirez la bonne chose ; traitez-la comme un fait du présent et vous passerez un mois à gérer des remboursements.

La bonne question pour un développeur n'est donc jamais seulement quel est le prix. C'est de quel type de prix il s'agit, quel âge il a, et ce que fera le système s'il s'avère faux.

Trois chiffres qu'on appelle tous prix

La plupart des fournisseurs renvoient les trois quelque part dans leur documentation, souvent sous le même nom de champ. Séparez-les dans votre modèle de données dès le premier jour.

ÉtatOrigineFraîcheurVendable ?À afficher
Prix de navigationRecherche en cache ou agrégée, conçue pour la vitesse et l'étenduePossiblement périmé, non calculé pour vos passagersNonMention « à partir de », avec l'indication qu'il peut changer
Offre tariféeRequête en direct pour l'itinéraire, les types de passagers et le tarif exactsFrais au moment de l'appel, avec une expiration ou un signal de retarificationOui, jusqu'à expirationLe total, taxes détaillées, conditions tarifaires
Montant émisCe que la compagnie ou le système d'émission a réellement facturé à la commandeDéfinitifDéjà venduLe reçu, rapproché de l'offre

Le prix de navigation rend possibles les calendriers et les pastilles « à partir de », et c'est une très bonne chose à construire. Mais ce n'est pas le même objet que la deuxième ligne. L'erreur, c'est un unique champ price dans lequel se déversent les trois.

Concrètement, cela donne trois types ou trois tables dans le code, pas un seul avec un drapeau. Le prix de navigation a le droit d'être un peu faux, puisqu'il n'est qu'une invitation à cliquer. L'offre tarifée est un engagement que vous êtes sur le point de prendre en votre nom : on la stocke avec l'heure de récupération, les entrées qui l'ont produite et l'identifiant que le fournisseur réclamera à la commande. Le montant émis relève de la comptabilité. Quand le support demande pourquoi un client a payé un autre chiffre que celui du courriel, la réponse se trouve dans l'écart entre les lignes, et vous ne pouvez le lire que si vous avez conservé les trois.

Ce que doit contenir une réponse de prix

Un chiffre seul ne suffit pas pour bâtir un paiement. En lisant l'exemple de réponse d'un fournisseur, cherchez ce qui suit, et méfiez-vous de tout ce qui arrive en texte libre.

  • La devise, indiquée dans la réponse, et non supposée à partir de votre compte.
  • Le tarif de base et les taxes séparément, pour afficher le détail et pour qu'un changement de taxe ne passe pas pour un changement de tarif.
  • Les types de passagers pour lesquels le prix a été calculé. Un prix adulte multiplié par trois n'est pas un tarif famille.
  • Les conditions tarifaires et les bagages sous forme de données structurées, car ce sont elles qui disent si l'option bon marché l'est vraiment pour votre client.
  • Une expiration ou un signal de retarification : un horodatage, ou une mention explicite qu'il faut retarifier avant de commander.

Ce dernier point est celui que l'on saute. Si rien dans la réponse ne dit combien de temps vit l'offre, vous devinez, et la devinette se fait en production.

Retarifier avant la commande, pas après

Le rythme le plus sûr contient une règle. On cherche pour naviguer. Quand le client choisit un itinéraire, on demande une offre tarifée en direct pour cet itinéraire et ces passagers précisément. On montre ce total au client. Seulement ensuite, on crée la commande. Si le prix en direct diffère de celui de la page de résultats, vous le dites au client avant qu'il paie, en termes clairs, et non après.

Sautez l'étape du milieu et vous héritez de la différence. Soit vous facturez plus que ce que le client a vu et perdez la vente à la page de paiement, soit vous honorez le chiffre le plus bas et l'écart sort de votre propre marge. Une petite agence peut absorber cela quelques fois ; elle ne peut pas l'absorber comme principe de conception.

À demander par écrit avant d'intégrer

La documentation décrit le chemin heureux. Le comportement qui vous coûte de l'argent se trouve dans les réponses à une courte liste de questions, et mieux vaut les avoir dans un courriel que dans un appel.

  1. Le prix de la réponse de recherche est-il en direct ou en cache, et est-ce indiqué dans la réponse elle-même ?
  2. Existe-t-il un appel de tarification distinct pour l'itinéraire exact, est-il obligatoire avant une commande ?
  3. Que se passe-t-il à la commande si le prix a bougé : un refus, un nouveau prix dans la réponse, ou une émission silencieuse au nouveau montant ?
  4. Comment les taxes et surcharges du transporteur sont-elles détaillées, et peuvent-elles changer entre tarification et émission ?
  5. Dans quelle devise le prix est-il calculé, et où se fait la conversion si le client en voit une autre ?
  6. Combien de temps une offre tarifée reste-t-elle valable, et comment le saurez-vous ?

Un fournisseur qui répond précisément a pensé au paiement. Celui qui répond « c'est toujours à jour » ne vous a rien donné que vous puissiez tester. Si vous ne pouvez pas essayer le comportement vous-même, c'est une raison de regarder l'ensemble autrement avant de construire dessus.

Ce que coûte l'erreur

Elle fait rarement du bruit. Elle se manifeste par une petite chute à l'étape du paiement que personne n'attribue au prix, par des tickets de support qui commencent par « le prix a changé », par un client qui a cru la page de résultats et ne la croit plus. Le personnel finit par reconfirmer les tarifs à la main avant l'émission. Quelqu'un propose enfin une règle qui arrondit les prix vers le haut par précaution, et le site devient cher sur le seul écran où l'on compare. Chacun de ces coûts est une taxe sur une décision qui coûtait peu à bien prendre au départ.

Où se situe cette plateforme

La plateforme expose des API de vols et d'hôtels, activées par locataire. L'accès commence par une conversation plutôt que par une clé en libre-service : il n'y a pas de formulaire qui vous remette un jeton et un tableau de limites. Nous ne publions ici ni latence, ni couverture, ni nombre de tarifs, car un chiffre dont nous ne pouvons pas montrer comment le tester ne mérite pas d'être imprimé. Vous pouvez en revanche apporter les questions ci-dessus à cette conversation et demander à voir la réponse pour une offre tarifée, pas seulement pour une recherche. Si vous en êtes là, la page des API de voyage est le point de départ.

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.