Avant d'engager une société d'intégration API à Dubaï

Trois devis sont posés sur le bureau. Chaque société d'intégration a un portfolio de sites de voyage, chacune promet de « connecter une API de vols à votre site », et la moins chère peut commencer la semaine prochaine. Vous dirigez une agence à Deira, six salariés, une clientèle d'entreprises fidèle, et vous en avez assez de recopier à la main les tarifs de l'extranet d'un fournisseur dans des messages WhatsApp. Choisir la société d'intégration API à Dubaï qui paraît la plus compétente semble être toute la décision.
C'en est à peu près un tiers. Les décisions qui déterminent si le site vendra ne figurent dans aucun des trois devis, parce qu'elles ne relèvent pas du code : avec qui le fournisseur a signé, au nom de qui les billets sont émis, où se trouve l'argent entre la réservation et l'émission, et qui traite le remboursement quand un client annule. Un intégrateur peut relier tout cela. Il ne peut tenir aucun de ces rôles à votre place.
Ce texte s'adresse au dirigeant qui signera le cahier des charges, pas au développeur qui le lira.
Ce qu'une société d'intégration API à Dubaï peut livrer, et ce qu'elle ne peut pas
Une société d'intégration écrit le code entre l'API d'un fournisseur et votre site : le formulaire de recherche, l'appel qui interroge la disponibilité, la vérification du prix avant paiement, la demande de réservation, les écrans qui affichent le résultat et, si le périmètre le prévoit, les appels d'annulation et de remboursement. Les bonnes prennent aussi en charge les parties ingrates qui comptent : les nouvelles tentatives quand un fournisseur tarde à répondre, des journaux qui permettent de retracer une réservation échouée, un environnement de test qui se comporte comme la production.
Ce qu'elle ne peut pas vous remettre, c'est tout ce qui se trouve de l'autre côté de ce code. Avant la première ligne, l'agence a besoin :
- d'un compte fournisseur au nom de l'agence, avec un accès API ouvert sur ce compte ;
- d'un droit d'émission, par sa propre accréditation ou par un consolidator qui émet pour son compte ;
- d'un arrangement financier avec ce fournisseur : dépôt, ligne de crédit ou paiements par carte transmis directement ;
- de quelqu'un pour le travail après émission (annulations, remboursements, réémissions, changements d'horaires), par l'API ou, à défaut, à la main.
L'intégrateur qui propose de « s'occuper du côté fournisseur » propose le plus souvent de vous prêter le sien. Pour un prototype, le raccourci peut se défendre. Pour une entreprise, cela signifie que votre site de réservation repose sur une relation que vous ne détenez pas et que vous ne pourrez pas emporter.
Le cahier des charges : sept lignes à écrire
La plupart des litiges avec un intégrateur remontent à une phrase que personne n'a écrite. Mettez ces points dans le document que vous signez, en termes simples, et demandez chaque réponse par écrit.
- Au nom de qui sont le compte fournisseur et les clés API. Au nom de l'agence. Les clés sont des identifiants : elles restent dans votre coffre-fort de mots de passe, et l'intégrateur reçoit un accès, pas la propriété.
- Qui héberge le site et qui détient le nom de domaine. Le domaine est enregistré au nom de l'agence. Le compte d'hébergement appartient à l'agence, ou le contrat précise exactement comment il est transféré.
- Quelles opérations entrent dans le périmètre. Nommez-les une à une : recherche, tarification, réservation, émission, annulation, remboursement, modification. Tout ce qui n'est pas sur la liste restera un e-mail au service du fournisseur pendant toute la vie du site. Remboursements et modifications sont les plus souvent oubliés, parce qu'aucune démonstration ne les montre.
- Qui assure la maintenance quand le fournisseur change son API. Les fournisseurs retirent des versions et renomment des champs. Un développement au forfait sans clause de maintenance s'arrête le jour où la première version change.
- Ce que veut dire « livraison ». Le code source dans un dépôt dont l'agence est propriétaire, tous les identifiants, et un document qui permet à un autre développeur de reprendre le travail. « On vous enverra un zip » n'est pas une livraison.
- Comment la mise en ligne est prouvée. Une réservation test de la recherche à l'émission dans l'environnement de test du fournisseur, annulation comprise, avant de débiter la carte d'un vrai client.
- Ce que deviennent les données clients. Noms des passagers, données de passeport, références de paiement : où elles sont stockées, qui peut les lire, comment elles sont supprimées.
Aucun de ces points ne demande de bagage technique pour être écrit. Chacun coûte moins cher à convenir avant le développement qu'à négocier après.
Trois façons d'amener le contenu fournisseur sur votre site
Engager un intégrateur sur l'API d'un fournisseur est une voie parmi trois. Elle mérite d'être vue à côté des deux autres avant qu'un devis ne choisisse pour vous.
| Voie | Qui détient la relation fournisseur | Qui maintient la connexion | Ce que l'agence doit encore construire | Ce que coûte un départ |
|---|---|---|---|---|
| Un intégrateur relie votre site à l'API d'un fournisseur | L'agence si le cahier des charges le dit ; sinon souvent l'intégrateur | L'intégrateur sous contrat de maintenance, ou personne | Back-office, marges, fichier clients, rapports, paiements, écrans d'après-vente | Peu si le code et les clés sont à vous ; une reconstruction sinon |
| Un intégrateur relie votre site à l'API d'une plateforme | La plateforme détient les contrats fournisseurs ; l'agence détient son compte sur la plateforme | La plateforme côté fournisseurs, l'intégrateur de votre côté | Votre site, et ce que l'API de la plateforme ne couvre pas | Réécrire votre partie pour une autre API |
| Une vitrine white-label déjà connectée | La plateforme, via le compte de l'agence | La plateforme | Les contenus, les décisions de prix, vos propres clients | Déplacer le domaine et le fichier clients chez un autre prestataire |
La ligne qui mérite débat est la première. Elle donne le plus de contrôle et vous laisse le plus de charge : chaque changement chez le fournisseur, chaque nouveau service, chaque opération oubliée par le premier développement devient un nouveau projet avec un nouveau devis.
La question d'ajouter une recherche à un site existant est traitée dans ajouter une recherche de vols à un site existant, et le choix de l'API qui se tient derrière dans choisir un fournisseur d'API de réservation de vols. Ce texte-ci porte sur le contrat autour du travail.
Où se situe cette plateforme
La plateforme derrière ce blog propose des API vols et hôtels. L'accès commence par une conversation et non par une clé en libre-service, parce que les premières questions sont celles ci-dessus (quels services, quel marché, comment circule l'argent) plutôt que le choix d'un endpoint. Les services sont activés compte par compte, et chaque compte dispose de son propre back-office avec ses réservations, ses clients, ses marges et ses rapports ; la colonne « doit encore construire » de la deuxième ligne est donc plus courte qu'il n'y paraît.
Si une société d'intégration doit construire votre partie, ayez cette conversation avant d'accepter un devis, pour que le périmètre décrive l'API à laquelle le site sera réellement connecté. La page des API voyage est le point de départ.
Ce que coûte un cahier des charges trop mince
Le site est en ligne. La recherche fonctionne, les prix paraissent justes, et la première réservation arrive un jeudi soir. Elle ne peut pas être émise au nom de votre agence, parce que le compte fournisseur appartient à l'intégrateur et émet sous son arrangement à lui. La carte du client a déjà été débitée. Vous voilà avec une réservation que vous ne pouvez ni émettre ni rembourser depuis votre propre site.
Ou bien tout fonctionne pendant un an. Puis le fournisseur passe à une nouvelle version de son API, la réservation s'arrête, et l'intégrateur, dont le forfait a pris fin à la livraison, chiffre un nouveau projet. Vous payez, parce que les seuls à comprendre le code sont ceux qui envoient le devis.
Ou l'intégrateur est tout simplement occupé ailleurs. Un passager doit faire corriger son nom sur un billet, l'opération de modification n'a jamais fait partie du périmètre, et deux de vos collaborateurs passent l'après-midi à écrire au service du fournisseur. C'est exactement le travail que le site devait supprimer.
Chacun de ces cas tient en une phrase absente du cahier des charges. Le code, lui, était correct à chaque fois.