Tests d'API voyage en sandbox : ce que le bac à sable cache

L'intégration a passé tout ce que les tests d'API voyage en sandbox pouvaient lui opposer. La recherche renvoyait des vols, l'appel de disponibilité hôtelière renvoyait des chambres, l'appel de réservation rendait un numéro de confirmation à chaque fois, et la QA a validé un jeudi. Le mardi suivant, un client a payé un hôtel à un prix que le fournisseur a confirmé à un autre, une réservation aérienne a expiré sans que personne ne sache si le siège était tenu, et un agent du support a passé l'après-midi à rapprocher deux dossiers décrivant le même voyage. Rien de tout cela n'était un bug raté par la suite de tests. C'étaient des scénarios qu'elle n'avait aucun moyen de voir. La sandbox est nécessaire, elle est très loin d'être suffisante, et c'est dans l'écart entre les deux que vivent la plupart des incidents coûteux d'une intégration voyage.
Voici un plan de test pour le développeur qui porte cette intégration : ce qu'une sandbox peut prouver, ce qu'elle ne peut structurellement pas prouver, et comment couvrir la différence sans réserver de vrais sièges sur la carte de l'entreprise.
Pourquoi les tests en sandbox valident un code que la production casse
Une sandbox est une promesse sur la forme des réponses, pas sur leur comportement. Le schéma est celui de la production. Le comportement ne l'est presque jamais, et ce n'est la faute de personne : un environnement de test ne peut pas se permettre de faire tourner un inventaire réel, il sert donc un jeu fixe de tarifs et de chambres qui ne s'épuisent jamais, ne changent jamais de prix et ne changent jamais d'horaire. Il répond vite parce que personne d'autre ne s'en sert. Il échoue rarement à mi-chemin.
La production fait tout cela chaque jour. L'inventaire est partagé avec tous les autres vendeurs ; les tarifs sont mis en cache quelque part en amont et vieillissent ; le système d'un fournisseur sous charge répond lentement, ou pas du tout. Un code qui n'a connu que la sandbox n'a, en pratique, été testé que face à un fournisseur qui passe une journée parfaite.
Traitez donc la sandbox comme une couche sur trois. Elle prouve que vos requêtes sont correctes et que votre parseur comprend le schéma. Les fixtures enregistrées prouvent que votre code survit aux réponses que la production envoie réellement. Un petit jeu délibéré de contrôles en conditions réelles prouve le câblage après un changement. Chaque couche attrape ce que les deux autres ne voient pas.
Les scénarios qu'une sandbox ne vous donne généralement pas
Écrivez-les avant d'écrire le moindre test. Une sandbox peut en simuler un ou deux avec une valeur de test magique ; la plupart, elle ne les a tout simplement pas.
| Scénario | Ce que fait la production | Comment le couvrir |
|---|---|---|
| Le prix change entre recherche et réservation | La réservation passe avec un autre total, ou échoue avec une erreur de changement de prix à afficher | Paire de fixtures : une réponse de recherche et une réponse de réservation au total différent ; vérifier que le voyageur est sollicité à nouveau, jamais débité en silence |
| Épuisé entre disponibilité et réservation | La chambre ou la classe tarifaire proposée n'existe plus au moment de la bloquer | Fixture de la vraie erreur « complet » du fournisseur ; vérifier que le voyageur revient aux résultats, pas sur une page d'erreur |
| Timeout sur l'appel de réservation | Le fournisseur a peut-être créé la réservation, peut-être pas | Injecter un timeout après l'envoi ; vérifier que le statut est interrogé avant toute nouvelle tentative |
| Double soumission | Un double clic ou un retry côté client crée deux réservations | Envoyer deux fois la même réservation avec la même clé d'idempotence ; vérifier qu'une seule existe |
| Changement d'horaire après émission | Le vol vendu part à une autre heure, ou sous un autre numéro | Fixture d'itinéraire modifié ; vérifier que le changement parvient à celui qui gère le client |
| Succès partiel d'une réservation combinée | Le vol est confirmé, l'hôtel non | Fixture mixte ; vérifier que le système enregistre exactement ce qui est confirmé et alerte un humain |
| Limitation de débit sous charge | Réponses rate limit, puis réponses lentes | Rejouer une réponse de limitation enregistrée ; vérifier le backoff et que la recherche se dégrade au lieu d'échouer |
Vous contesterez peut-être la dernière colonne pour votre propre stack. Très bien. L'essentiel est que chaque ligne ait un responsable et une assertion, parce que chacune finira par vous arriver.
Construire les fixtures à partir de vraies réponses
L'habitude la plus utile dans une intégration voyage, c'est de garder les réponses qui vous ont surpris. Des données factices écrites à la main reflètent ce que vous croyez que le fournisseur envoie ; une réponse enregistrée reflète ce qu'il a vraiment envoyé, y compris les champs vides que la documentation dit toujours remplis, le prix dans une devise que vous n'avez pas demandée et l'erreur qui arrive avec un statut de succès.
Une routine qui fonctionne :
- Enregistrer à la frontière. Journalisez les corps bruts des requêtes et réponses fournisseurs hors production, et en production sur un échantillon du trafic si vos règles de confidentialité le permettent.
- Nettoyer avant de conserver. Noms des passagers, numéros de passeport, e-mails, téléphones et références de paiement sortent avant que la fixture n'entre dans le dépôt. Remplacez-les par des valeurs manifestement fausses pour que personne ne la prenne pour une vraie réservation.
- Nommer par comportement.
hotel-book-price-increased.jsondit au développeur suivant pourquoi le fichier existe ;response-17.jsonne dit rien. - Garder les plus laides pour toujours. La réponse malformée qui a fait tomber la recherche un dimanche est le fichier le plus précieux que vous ayez. Sa place est dans un test qui tourne à chaque commit.
Écrivez ensuite des tests de contrat sur ces fixtures : votre parseur, votre mapping vers vos modèles internes, votre classification d'erreurs. Si un fournisseur renomme un champ et qu'un test de contrat échoue, vous l'apprenez en CI et non par un client. Le volet classification est détaillé dans notre article sur la gestion des erreurs d'API d'un moteur de réservation.
Tester les flux d'argent sans dépenser d'argent
C'est là que la sandbox aide le moins, car les flux d'argent sont précisément l'endroit où un environnement de test diffère du réel. L'émission réelle, la capture réelle de carte et la facturation réelle des fournisseurs sont ce qui doit être juste avant tout, et ce qu'on peut le moins répéter en direct.
Découpez le problème. Le calcul des prix est de la logique pure, testable exhaustivement hors ligne : prenez des tarifs enregistrés, appliquez vos règles de marge, la conversion de devises et l'arrondi, et vérifiez le total que voit le voyageur. Faites-le pour les cas pénibles : un tarif en USD vendu en EUR, une marge en pourcentage sur un produit et en montant fixe sur un autre, un tarif enfant, une étape d'arrondi différente entre affichage et débit. Un total faux de quelques centimes reste faux, et il l'est sur chaque réservation.
La seconde moitié, ce sont les transitions d'état autour du paiement. Modélisez-les explicitement : devisé, en option, payé, confirmé, émis, annulé, remboursé. Et testez que chaque transition a exactement une cause. Le test qui attrape le bug le plus cher est celui qui vérifie qu'un paiement ne peut pas être capturé pour une réservation non confirmée par le fournisseur, et qu'une réservation confirmée ne peut pas exister sans trace de paiement.
Enfin, rendez impossible qu'un run de tests atteigne l'émission réelle. Pas improbable : impossible. Une vérification au démarrage qui refuse de lancer la suite quand des identifiants de production sont chargés tient en une ligne et évite la pire matinée qu'une équipe d'intégration puisse connaître.
Ce que coûte une erreur ici
Un scénario oublié dans une intégration voyage se manifeste rarement par une erreur. Il se manifeste par une réservation qui a l'air normale. Un billet en double que personne n'a demandé et que quelqu'un doit annuler (void) avant l'échéance. Un hôtel confirmé à un prix que l'agence doit maintenant absorber. Une réservation expirée que le système a relancée : le fournisseur tient deux chambres et facture les deux. Pour un billet d'avion vendu par une agence, un écart entre ce qui a été émis et ce qui a été vendu peut revenir plus tard sous forme d'ADM, bien après que la marge de la vente a été dépensée.
Ces coûts retombent sur l'entreprise qui a vendu le voyage, pas sur le développeur qui a écrit la boucle de retry. C'est tout l'argument pour les tester avant le lancement plutôt que de les découvrir ticket de support après ticket de support.
Les tests de fumée après chaque changement fournisseur
Les fournisseurs changent des choses : une nouvelle version d'API, un nouveau point d'accès, un identifiant renouvelé, un mapping de contenu différent. Votre propre code n'a peut-être pas bougé. Passez quand même cette liste, dans l'environnement qui parle au fournisseur concerné :
- Une recherche par produit vendu via ce fournisseur, sur une route ou une ville dont vous savez qu'elle renvoie des résultats, par exemple Paris–Dubaï.
- Parsez tous les résultats sans en écarter aucun en silence ; comparez votre décompte à celui de la réponse brute.
- Tarifez un résultat de bout en bout et comparez le total affiché à votre propre calcul depuis le tarif brut.
- Faites une réservation dans l'environnement de test, relisez son statut et comparez chaque champ que vous stockez.
- Annulez-la et vérifiez que l'annulation apparaît dans vos dossiers comme chez le fournisseur.
- Rejouez vos fixtures « laides » à travers le nouveau parseur.
- Vérifiez que timeouts et limitations de débit mènent toujours au comportement que vous avez décidé : une nouvelle version peut y répondre autrement. Si les temps de réponse ont bougé, notre article sur la latence explique quelle part vous revient.
Assez court pour être lancé à chaque fois, et c'est tout l'intérêt. Un test de fumée que personne ne lance parce qu'il prend une journée n'en est pas un.
La juste place de la sandbox
Rien de tout cela ne rend la sandbox moins utile. Cela la rend honnête : l'endroit où l'on apprend le schéma et où l'on confirme que les requêtes sont justes, avant que fixtures et contrôles réels prennent le relais là où elle ne va pas. Si vous évaluez les API vols et hôtels de la plateforme, l'accès commence par une conversation plutôt que par une clé en libre-service : apportez ce plan de test à cette conversation et demandez comment chaque ligne du tableau ci-dessus serait couverte. Les réponses vous en diront plus sur une API que sa documentation.