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

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.
| État | Origine | Fraîcheur | Vendable ? | À afficher |
|---|---|---|---|---|
| Prix de navigation | Recherche en cache ou agrégée, conçue pour la vitesse et l'étendue | Possiblement périmé, non calculé pour vos passagers | Non | Mention « à partir de », avec l'indication qu'il peut changer |
| Offre tarifée | Requête en direct pour l'itinéraire, les types de passagers et le tarif exacts | Frais au moment de l'appel, avec une expiration ou un signal de retarification | Oui, jusqu'à expiration | Le total, taxes détaillées, conditions tarifaires |
| Montant émis | Ce que la compagnie ou le système d'émission a réellement facturé à la commande | Définitif | Déjà vendu | Le 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.
- 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 ?
- Existe-t-il un appel de tarification distinct pour l'itinéraire exact, est-il obligatoire avant une commande ?
- 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 ?
- Comment les taxes et surcharges du transporteur sont-elles détaillées, et peuvent-elles changer entre tarification et émission ?
- Dans quelle devise le prix est-il calculé, et où se fait la conversion si le client en voit une autre ?
- 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.