
Comparatif documenté · 3 périmètres
API aériennes : accès Enterprise, partenaire sélectionné ou sandbox
L’existence d’une documentation de vols ne prouve pas que votre entreprise peut ouvrir un compte, émettre un billet ou traiter une modification. Comparez d’abord le mode d’accès et les responsabilités après la vente.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
Portail Enterprise ; ancien Self-Service retiré | Le portail officiel annonce le retrait du portail Self-Service le 17 juillet 2026 et présente désormais les API Enterprise, avec demande d’accès et sandbox Enterprise. Amadeus : annonce et portail Enterprise ↗Consulté le | Les anciennes FAQ Self-Service restent parfois indexées. Elles ne prouvent pas qu’un nouvel accès à cette ancienne offre est disponible. | Quel produit Enterprise, contrat et environnement de test sont ouverts à notre entreprise, et quel acteur émet et suit les billets ? |
API de vente ; mode test distinct de la production | Les jetons de test et de production accèdent à des ressources séparées. Duffel Airways simule les parcours, avec des horaires et prix artificiels ; les sandboxes des compagnies externes ont leurs propres limites. Duffel : ce que démontre le mode test ↗Consulté le | Un résultat en simulation ne démontre ni disponibilité commerciale ni couverture après-vente d’une compagnie réelle. | Quels parcours seront vérifiés sur les compagnies et le marché du lancement ? |
Partenariats sélectionnés | L’annonce du 30 mai 2024 réserve les nouveaux partenariats Tequila à une invitation. Elle indique la poursuite des services B2B pour les partenaires existants sélectionnés. Kiwi.com : accès aux partenariats Tequila ↗Consulté le | Annonce de politique partenaire ; ni invitation ni fonctions d’un compte précis ne sont établies par sa lecture. | Votre organisation dispose-t-elle d’une invitation et d’un périmètre confirmé par écrit ? |
Une décision d’accès précède la décision d’architecture
Une équipe peut consacrer plusieurs semaines à un prototype avant de découvrir qu’elle ne dispose pas du droit de vendre le contenu recherché. La première preuve à obtenir est donc une réponse du programme partenaire sur le modèle envisagé : pays de vente, clientèle, canaux, flux de paiement et personne chargée de l’après-vente. Une capture de documentation constitue un repère technique ; une validation de partenariat constitue une étape commerciale différente.
Le retrait d’une offre développeur impose aussi de distinguer l’entreprise, le portail et le produit. Conservez le nom historique dans le registre de migration pour retrouver les anciens dossiers, mais ne présentez plus son inscription comme une voie de lancement. Vérifiez quelle offre actuelle peut répondre au besoin, sans supposer qu’elle reprend les tarifs, quotas, opérations ou conditions de l’ancienne.
Comparer le même dossier, jusqu’au billet et au changement
Décrivez un trajet avec les mêmes passagers, dates, aéroports, bagages et devise. Notez séparément les étapes de recherche, revalidation, commande, paiement et émission. Un identifiant de commande et un billet sont deux objets à rapprocher. La démonstration doit expliquer comment votre équipe reconnaît une émission réussie et comment elle retrouve l’état final lorsqu’une réponse manque.
Ajoutez un changement demandé par le voyageur et une perturbation initiée par le transporteur. Relevez ce qui est automatisé, transmis à un partenaire ou traité manuellement. La responsabilité du service après fermeture de l’agence doit être explicite. Le tableau ci-dessus compare des modalités documentées ; il ne constitue pas un classement de prix, de couverture aérienne ou de qualité de support.
Préparer une migration qui conserve l’historique
Un changement de fournisseur n’efface pas les dossiers vendus précédemment. Inventoriez les commandes, références compagnie, billets, services annexes et remboursements ouverts. Affectez à chaque dossier un système responsable et un canal d’intervention. Gardez un export opérationnel exploitable par les personnes autorisées, sans inclure de secret ou d’information de paiement dans un document partagé.
Faites démarrer le nouveau flux sur un périmètre limité et maintenez le suivi des anciens dossiers jusqu’à leur clôture. La comparaison financière doit inclure l’effort de reprise, le support, les connexions et les interventions manuelles. Une API dont l’accès est confirmé mais qui ne couvre pas vos exceptions prioritaires peut demander davantage d’organisation qu’une solution moins personnalisée.
Conserver les commandes après la fermeture d’un accès
Scénario de préparation : le pilote s’arrête alors que des billets ou demandes de changement restent ouverts. Faites désigner qui retrouve chaque commande, qui traite l’après-vente et quel accès demeure nécessaire. Le retrait de la clé et la clôture commerciale ne sont pas le même événement.
Demandez un export de références sans données sensibles inutiles, une liste des opérations encore possibles et un canal de reprise confirmé. La preuve de sortie relie commandes ouvertes, échéances d’émission et responsabilités jusqu’à leur résolution.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le bon mode d’accès dépend de votre rôle et des opérations que vous devez assumer. Commencez par le droit de distribuer et le circuit d’émission, puis examinez la personnalisation du parcours. Une documentation accessible ne suffit pas à dimensionner le lancement commercial.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Prototype sans vente
Cas fictif : votre équipe sait rechercher des vols simulés et lire une offre, mais ne dispose d’aucune autorisation de vente sur le compte prévu. Retenir ce périmètre pour apprendre les échanges et préparer les essais suivants.
Avant de retenir ce périmètre : Le résultat attendu est une liste des opérations testées et des accès manquants, sans promesse d’émission. Une réservation de simulation ne valide ni les marchés, ni les transporteurs, ni les actes ouverts en production.
Agence avec circuit d’émission existant
Cas fictif : l’agence possède un circuit d’émission et souhaite automatiser la recherche. Les changements restent traités par ses agents dans un autre outil. Comparer le lien entre offre recherchée, dossier et intervention humaine.
Avant de retenir ce périmètre : Faire reprendre un dossier par un second agent avec les références conservées. Retenir l’intégration seulement si le circuit d’émission et la relève demeurent utilisables, y compris lorsque l’API ne traite pas le changement demandé.
Nouveau distributeur numérique
Cas fictif : le lancement vise deux marchés et trois opérations : rechercher, réserver et retrouver le dossier. Un partenaire couvre l’émission, tandis que le support des changements reste indéfini.
Avant de retenir ce périmètre : Délimiter le lancement aux marchés et opérations dont les responsables sont confirmés. Chiffrer séparément les interventions après vente et différer les parcours sans relais, même si la démonstration de recherche est convaincante.
Arbitrer les contraintes et le coût de fonctionnement
Un lancement rapide peut limiter la personnalisation ou déléguer davantage d’opérations. Une API plus configurable peut imposer développement, suivi et habilitations supplémentaires. Comparez le coût d’un dossier complet sur un volume expliqué, avec incidents et interventions humaines ; un coût par appel ne représente pas le coût de service d’un voyage. Pour comparer la charge, un exercice fictif porte sur 200 dossiers : deux minutes de reprise sur chacun représentent 6 h 40 ; dix incidents de vingt minutes ajoutent 3 h 20. Le total atteint dix heures de travail, avant les frais de connexion. Demandez si ces tâches disparaissent, changent d’équipe ou se déplacent après la vente. Un tarif d’accès inférieur ne compense pas automatiquement une émission plus difficile à suivre.
Points à clarifier avant la décision
- Le compte de production prévu ne dispose pas d’un accès confirmé sur un marché ou une compagnie du lancement.
- Aucune équipe ne peut retrouver le dossier et décider de la reprise lorsqu’une émission ou un changement reste incertain.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Une même offre à deux instants | Cas fictif : offre 400 €, bagage 35 €, puis offre relue à 420 €. Faire confirmer le prix accepté et le droit de réserver sur le compte cible. | Total accepté de 455 € dans ce cas, horodatage, identifiant d’offre et preuve de commande ; sinon étape bloquante nommée. |
| Prototype de recherche | Distinguer offre simulée et inventaire réel | Environnement, transporteur et fonctions réellement testées |
| Réponse de réservation perdue | Simuler une coupure après envoi dans un environnement autorisé. Retrouver le dossier avant de décider une nouvelle tentative. | Une seule réservation, un statut expliqué et la procédure de recherche fournie pour ce produit. |
| Modification d’un billet | Identifier l’opération disponible et l’équipe responsable | Conditions du tarif, frais annoncés et état du billet après traitement |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
Peut-on encore lancer un projet avec l’ancien Amadeus Self-Service ?
Le portail officiel annonce son retrait au 17 juillet 2026. Pour un nouveau projet, examinez l’accès Enterprise actuel et demandez confirmation du produit et des conditions applicables.
Un sandbox confirme-t-il la disponibilité commerciale ?
Il valide les scénarios qu’il reproduit. Les droits du compte réel, les compagnies activées, les conditions tarifaires et les opérations après-vente restent à vérifier séparément.
Faut-il remplacer tous les anciens dossiers lors d’une migration ?
Préservez leurs références et leur circuit de traitement. Le nouveau système doit coexister avec les engagements en cours jusqu’à ce que leur reprise ou leur clôture soit contrôlée.
Quel périmètre lancer en premier ?
Commencez par un périmètre dont accès, émission, paiement et support sont attribués. Dans un prototype, distinguez les opérations simulées des actes autorisés en production. Pour un lancement marchand, faites aussi reprendre une réservation par l’équipe qui assurera les changements ; une recherche réussie ne démontre pas ce parcours complet.
Documentation et application
Les précisions utiles des sources
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.
Examiner le dossier et son périmètre.
Duffel : confirmer le service de siège du bon passager
La présence d’une place sur le plan ne suffit pas à la réserver. Le service sélectionné doit correspondre au passager et apparaître dans la commande obtenue.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Disponibilité | Un siège sans available_services, représenté par une liste vide, est indisponible dans ce parcours. | Ne le proposez pas comme un choix gratuit ou comme une place encore réservable. |
| Prix par passager | Un même siège peut avoir un service et un prix différents selon le passenger_id. | Conservez le service du voyageur concerné ; ne copiez pas le prix du premier passager pour tous les autres. |
| Commande | Dans services, chaque siège se transmet avec son id de service et quantity égal à 1. Le paiement inclut le prix de l’offre et des services choisis. | Vérifiez le montant complet avant création, sans multiplier un service de siège comme une quantité de bagages. |
| Résultat obtenu | La réponse de commande contient les sièges dans services et leur désignation dans seat pour le passager du segment. | Rapprochez demande et résultat. Un numéro 12A doit encore être relié au bon vol et au bon voyageur. |
Parcours Duffel documenté, sans extension à toutes les compagnies ni garantie de conservation du siège après changement de vol ou d’appareil.
Duffel — Adding Seats, services et commande créée · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
Duffel : une place retenue et un prix garanti ont deux échéances
Pour un vol sous option, le conseiller doit pouvoir répondre à deux questions : jusqu’à quand la place est-elle retenue, et jusqu’à quand le prix est-il garanti ?
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Offre éligible | requires_instant_payment: false indique qu’une offre peut être retenue sans paiement immédiat. | Contrôlez l’offre reçue ; la possibilité ne concerne pas toutes les compagnies. |
| Garantie de prix | price_guarantee_expires_at indique la fin de garantie du prix. Une valeur null signifie que le prix peut changer pendant la retenue. | Affichez cette information séparément de la limite de paiement. |
| Fin de la retenue | Sans paiement avant payment_required_by, la compagnie libère la place et awaiting_payment passe à false. | Ce dernier état ne suffit donc pas à conclure que le client a payé. |
| Avant paiement | Relire la commande donne le prix courant ; un montant devenu ancien peut produire l’erreur price_changed. | Comparez les montants et faites valider l’écart avant de poursuivre. |
Exemple fictif : prix garanti jusqu’à 16 h et paiement exigé avant 18 h, dans le même fuseau. À 17 h, la place peut encore être retenue sans que le prix de 15 h soit garanti. Ces heures illustrent la distinction ; elles ne sont pas des délais Duffel.
Duffel — retenir une commande et payer plus tard · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
Duffel : lire la limite du point d’accès et l’heure de réouverture
Une recherche bloquée par un quota demande de relire les en-têtes de la réponse. Elle ne prouve pas une panne de la compagnie.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Quota appliqué | ratelimit-limit donne le plafond de la période et ratelimit-remaining le nombre restant. | Conserver le point d’accès et l’environnement ; ne pas recopier le quota d’une autre opération. |
| Reprise après 429 | Le code rate_limit_exceeded demande d’attendre le moment indiqué par ratelimit-reset, exprimé comme une date HTTP. | Lire une date, pas un nombre de secondes ; éviter de renvoyer immédiatement tous les appels en attente. |
| Autres erreurs | Le tableau Duffel demande de ne pas réessayer les erreurs serveur 500 et 502 et de transmettre le request_id au support. | Définir le traitement par code et par opération, sans règle universelle « toute erreur serveur se relance ». |
Comportement Duffel documenté. Aucune limite de compte ni autorisation de nouvelle réservation ne découle de cet exemple ; une écriture à résultat incertain doit être rapprochée séparément.
Duffel — Response handling · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.