
Intégration et accès
API voyage : ce qu’un sandbox permet de prouver avant la production
Un test réussi vérifie une intégration dans un environnement donné. Il ne prouve pas que les mêmes compagnies, hôtels, prix ou opérations seront accessibles en production. Séparez validation technique, accès commercial et capacité à servir un dossier réel.
Nommer les trois environnements que l’on confond souvent
| Environnement | Ce qu’il aide à vérifier | Ce qui reste ouvert |
|---|---|---|
| Simulation locale | Écrans, états et traitement des erreurs prévus. | Comportement du partenaire et données vendables. |
| Sandbox fournisseur | Format, appels et opérations disponibles dans le test. | Couverture commerciale et fiabilité réelle. |
| Production autorisée | Résultats sur les marchés et comptes ouverts. | Montée en charge, exceptions rares et évolution des conditions. |
Demandez si le test utilise un catalogue figé, un simulateur ou une connexion aux environnements des transporteurs. Cette différence explique des prix atypiques, des horaires artificiels ou une opération indisponible. Consignez-la dans le compte rendu, au lieu de comparer directement les volumes de résultats.
Deux exemples documentés qui changent le cadrage
Le mode test de Duffel comprend une compagnie de simulation, Duffel Airways. Sa documentation indique que ses horaires et prix ne sont pas réalistes. Elle décrit aussi les limites des sandbox externes des compagnies. C’est utile pour tester le traitement d’une commande, mais insuffisant pour évaluer une desserte ou une marge.
Booking.com demande de remplir les prérequis du programme Managed Affiliate Partner avant l’usage de la Demand API. L’accès à une documentation publique ne suffit donc pas à établir une date de lancement. Les références officielles sont regroupées en fin de guide ; leurs conditions doivent être relues au moment de votre projet.
Construire une matrice de passage à la production
Pour chaque marché et produit, notez recherche, prix final, création de commande, paiement, document, changement et annulation. Ajoutez les rôles d’émission et de support. Utilisez quatre états : démontré dans le test, confirmé par écrit pour la production, absent, à vérifier. Un « oui » global masque trop de différences entre opérations.
Complétez avec langue, devise, occupation, types de passagers et contraintes horaires. Si un cas est manuel, indiquez qui le traite et dans quel délai. Une API qui automatise la vente mais laisse tout l’après-vente à l’équipe doit être évaluée avec cette charge. Le coût complet permet de la comparer à une autre architecture.
Tester les états incertains avant les écrans parfaits
- Faire évoluer le prix entre recherche et confirmation.
- Simuler un délai dépassé après l’envoi d’une commande.
- Retrouver cette commande avant de la recréer.
- Recevoir deux fois un événement ou dans un ordre différent.
- Annuler une partie du dossier et rapprocher le remboursement.
Les webhooks et les identifiants de réservation doivent permettre de retrouver un état fiable. Préparez les simulations avec le fournisseur ; elles ne se déclenchent pas au hasard sur de véritables voyageurs.
Lancer sur un périmètre que l’équipe peut réellement suivre
Choisissez une famille de produits, un marché et une équipe. Définissez un responsable des exceptions, une fréquence de rapprochement et des conditions d’arrêt : prix incohérent, paiement sans réservation retrouvable ou absence de support opérationnel. Fixez les seuils avec vos données ; aucun seuil universel ne remplace le niveau de service promis.
Conservez la version testée, les résultats et les limites connues. Étendez seulement quand les dossiers du premier périmètre sont suivis jusqu’à leur clôture. Une disponibilité technique et une bonne conversion ne suffisent pas si le service client doit reconstituer chaque dossier à la main.
Trois documents pour décider
- Une matrice d’opérations datée par marché et produit.
- Un compte rendu de recette avec références et états finaux anonymisés.
- Une procédure de support, de rapprochement et de retour à l’existant.
Les modèles pratiques aident à rédiger ces documents. Le résultat attendu est une décision compréhensible : ce qui fonctionne, pour qui, avec quelles limites et qui intervient quand le parcours échoue.
Une sandbox ne documente pas les droits commerciaux
Construisez une matrice par transporteur, marché et opération : recherche, émission, ajout de service, échange et remboursement. Conservez la différence entre fonction visible en test, fonction accordée sur votre compte et fonction démontrée en production. Un portail développeurs ou une page marketing ne prouve pas les trois. Pour un changement de gamme ou de portail, faites confirmer la date de fermeture, le canal de remplacement et les opérations encore possibles sur les dossiers déjà créés.
Aérien : PSS, retail, marketing des offres ou portail agence ? : fonctions documentées, limites et questions à poser à quatre acteurs du secteur.
Tester l’accès qui expire avant la fin du traitement
Préparez une lecture interrompue par la fin de validité de l’accès et un renouvellement qui demande une nouvelle autorisation. Le traitement ne doit pas annoncer une couverture complète à partir des seuls objets déjà reçus. Conservez le compte, l’environnement, les références traitées et celles à reprendre. Un accès valable en sandbox ne démontre pas les droits de production ; le passage doit contrôler les opérations et leur périmètre sans déplacer les secrets dans les documents du projet.
OAuth dans la travel tech : déléguer un accès et organiser sa fin
Préparer aussi le prochain remplacement de l’accès
Avant de déclarer l’intégration exploitable, identifiez qui peut remplacer et retirer les accès techniques. Le plan de rotation des clés API relie les droits, consommateurs et preuves. Un accès de production fonctionnel ne démontre pas que le traitement nocturne ou la récupération d’un secret est organisé.
Le contrôle de rotation conserve les inconnues et les prochaines exécutions à observer, sans opération commerciale réelle ni copie du secret.
Rejouer une rupture de contexte avant lancement
Scénario fictif : Le sandbox montre une trace continue, mais un connecteur de production ne participe pas au même flux. Faites préciser les références alternatives et la procédure de support.
| Point | Preuve | Contrôle proposé |
|---|---|---|
| Contrat à conserver | Composants et références disponibles | Faire préciser ce qui est fourni et ce que le traitement peut conclure. |
| Résultat à rapprocher | Diagnostic malgré la rupture | Comparer le résultat effectivement observé à celui attendu pour ce cas. |
| Décision de reprise | Une démonstration locale ne certifie pas la traçabilité chez le partenaire. | Attribuer la suite et garder l’inconnue visible tant que la preuve manque. |
Une démonstration locale ne certifie pas la traçabilité chez le partenaire.
Cadre documentaire : W3C : Trace Context, recommandation — référence consultée le . Contexte de traçage distribué ; ne remplace ni référence de réservation, ni état métier, ni preuve complète de traitement.
Duffel : identifier et vérifier les notifications aériennes
Le guide distingue configuration, contrôle cryptographique et unicité du traitement. Ces trois points ne se remplacent pas mutuellement.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Changement compagnie | order.airline_initiated_change_detected signale un changement initié par la compagnie. | Relire la commande et qualifier les conséquences pour les voyageurs ; la notification ne vaut pas accord du client. |
| Signature | Le contrôle emploie X-Duffel-Signature et un secret ; ce secret n’est montré qu’à la création du webhook. | Prévoir stockage protégé et rotation sans écrire le secret dans les journaux. |
| Doublons | Duffel indique d’utiliser idempotency_key pour l’unicité des événements rejoués. | Ne pas inventer une clé de dédoublonnage à partir de la date de réception. |
| Environnements | Webhooks test et production sont séparés ; live_mode permet de les distinguer. | Ne pas compter un ping de connectivité comme une réservation réelle traitée. |
Comportement décrit par Duffel, à ne pas généraliser aux webhooks de tous les fournisseurs.
Duffel — Receiving webhooks · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Apaleo : préparer les essais sans confondre réinitialisation et archivage
Un établissement de test ne suit pas le même cycle qu’un établissement en production. Avant une recette ou une migration, relevez son statut et les paramètres fixés à sa création.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Paramètres fixés à la création | Le pays, le fuseau horaire et la devise ne peuvent plus être modifiés ; Apaleo demande de créer un nouvel établissement pour changer ces valeurs. | Contrôlez ces trois données avant de préparer les jeux d’essai et les rapprochements. |
| Réinitialisation en test | Reset supprime les réservations, folios et paiements de l’établissement de test, en conservant ses réglages. | Préparez un nouveau jeu de transactions ; ne cherchez pas les anciens dossiers dans un environnement réinitialisé. |
| Suppression ou archivage | Delete retire définitivement un établissement de test. Un établissement en production peut être archivé : son historique reste consultable en lecture seule. | Distinguez la conservation de l’historique de la possibilité de poursuivre une activité. |
| Rôle d’administration | La zone de réinitialisation, suppression et archivage exige Account Admin ; Property Admin peut modifier les autres informations décrites sur cette page. | Attribuez l’action sensible à une personne habilitée plutôt que de déduire ses droits du seul accès à la fiche. |
Deux choix d’environnement à documenter
Scénarios fictifs ; aucune instruction n’est exécutée sur un compte fournisseur.
Le test doit passer d’une devise à une autre
L’équipe prépare un établissement de démonstration créé avec une devise différente de celle de la recette.
Établissement : test
Devise à la création : EUR
Devise attendue pour l’essai : GBPLecture du cas. Un changement de devise ne se traite pas comme une correction d’adresse. Préparez un nouvel établissement avec les bons paramètres et une correspondance explicite entre anciens et nouveaux objets.
L’historique doit rester lisible après la fermeture
Un établissement fictif en production ferme définitivement, mais l’équipe doit consulter ses anciens dossiers.
Statut : production
Besoin : consulter les données passées
Nouvelles réservations : arrêtéesLecture du cas. L’archivage rend l’établissement accessible en lecture seule. Il ne constitue ni une suppression des données ni un mode permettant de continuer les nouvelles opérations.
Fonctions de l’interface Apaleo décrites dans l’aide mise à jour le 15 octobre 2026. Elles ne prouvent pas qu’une API ou un rôle personnalisé autorise les mêmes actions. Aucun établissement réel n’est modifié par ces exemples.
Apaleo — Set Up Your Property Details · mise à jour par la source le 15/10/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- Duffel : fonctionnement du mode test : Différence entre compagnie de test, sandbox compagnie et données réelles. (consultée le )
- Booking.com Demand API : prérequis : Accès partenaire requis avant l’utilisation du service. (consultée le )
- Navitaire : Système de réservation de compagnie : New Skies est présenté comme un système de réservation et de distribution relié notamment aux canaux directs, GDS et services de départ. (consultée le )
- Accelya : Plateforme de retail aérien : Accelya présente FLX ONE comme une plateforme modulaire couvrant Offer, Order, Settle et Deliver pour les compagnies aériennes. (consultée le )
- PROS : Marketing des offres de compagnie : PROS Offer Marketing distingue des pages de destination airTRFX, modules airModules et interfaces airWire pour diffuser des offres sur les canaux numériques. (consultée le )
- Resaneo : Centrale de réservation pour agences : Resaneo présente une interface dédiée aux agences, avec vols, rail, services additionnels et contenus de transporteurs accessibles via NDC. (consultée le )
- W3C : Trace Context, recommandation : Contexte de traçage distribué ; ne remplace ni référence de réservation, ni état métier, ni preuve complète de traitement. (consultée le )
- Duffel — Receiving webhooks : Comportement décrit par Duffel, à ne pas généraliser aux webhooks de tous les fournisseurs. (consultée le )
- Apaleo — Set Up Your Property Details : Fonctions de l’interface Apaleo décrites dans l’aide mise à jour le 15 octobre 2026. Elles ne prouvent pas qu’une API ou un rôle personnalisé autorise les mêmes actions. Aucun établissement réel n’est modifié par ces exemples. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Un sandbox contient-il les prix réellement vendables ?
Pas nécessairement. Il peut servir des jeux synthétiques, des données limitées ou un environnement de fournisseur. Demandez à quoi correspond le jeu testé et ce qui change en production.
Une documentation publique donne-t-elle accès à la production ?
Non. Un contrat partenaire, une validation commerciale ou une habilitation peut être nécessaire. Vérifiez les prérequis officiels avant de planifier le lancement.
Quelles preuves faut-il avant la mise en vente ?
Un accès confirmé pour le périmètre choisi, une matrice des opérations, une recette des exceptions, un rapprochement paiement-réservation et un circuit de support.
Comment comparer deux API qui ont des environnements de test différents ?
Comparez les mêmes résultats métiers et notez les limites de chaque environnement. Séparez les cas démontrés, simulés, non disponibles et encore à confirmer en production.
Rejouer une rupture de contexte avant lancement : quelle preuve conserver ?
Conservez composants et références disponibles, diagnostic malgré la rupture et la décision attribuée. Une démonstration locale ne certifie pas la traçabilité chez le partenaire.
Réinitialiser un établissement Apaleo de test conserve-t-il les réservations ?
Non. L’aide indique que Reset efface les transactions, dont les réservations, folios et paiements, tout en conservant les réglages. Cette opération exige Account Admin ; préparez les dossiers à rejouer avant de la demander.
Tableau de travail
Préparer une ouverture d’intégration
Proposition de revue éditoriale ; cocher un point ne valide ni un fournisseur ni une réservation.
| Point | Pièce à rapprocher | Suite à préparer | Votre revue |
|---|---|---|---|
| Périmètre | Fonctions autorisées dans chaque environnement | Faire confirmer les différences avant de transposer un essai. | |
| Parcours | Dossier de recette et résultat observé | Rejouer les exceptions prévues avant la mise en service. | |
| Exploitation | Contact, suivi et procédure de retour | Attribuer la surveillance et la reprise. |
0 / 3 points marqués comme examinés.
Les marques restent dans cet onglet et ne sont ni envoyées ni enregistrées par ce module.





