Avant de choisir

Intégration d’API : relier votre site à vos autres logiciels

Une API est la porte par laquelle deux logiciels s’échangent des données sans que personne ne recopie rien. Ce que ça relie sur un site de PME, quoi demander, et quand ça devient un chantier.

Publié le

Dans quel sens les données vontTrois sens d’échange entre un site et un autre logiciel : du site vers l’outil, dans les deux sens pour le stock et l’agenda, et du paiement vers le site.Dans quel sens les données vontDu site vers l’outilFormulaire vers suivi des clients, boutique verscomptabilité, site vers infolettreDans les deux sensBoutique et inventaire, réservation et agenda : lesdeux côtés restent à jourVers le siteUn paiement reçu est confirmé au site, sansconfirmation à la main
Une liaison évite de recopier à la main : elle va du site vers l’autre logiciel, dans les deux sens, ou vers le site.
Un faisceau de câbles réseau bleus et jaunes enroulés sur une étagère en bois, au premier plan, avec un bureau et une chaise flous au fond.

Une intégration d’API consiste à brancher votre site sur un autre logiciel (comptabilité, courriel, gestion des clients, paiement, inventaire) pour que les deux s’échangent des données d’eux-mêmes. Au lieu de recopier à la main une demande reçue par le formulaire dans votre outil de suivi, le site l’y envoie. Au lieu de mettre à jour un stock à deux endroits, un seul fait foi. Ce billet explique ce que ça change pour une PME, sans code, et ce qu’il faut décider avant de payer quelqu’un pour le faire.

Une API, c’est une porte avec des règles

La documentation de Mozilla décrit une API comme un ensemble de fonctions et de règles qu’un logiciel expose pour permettre l’interaction par un autre logiciel, plutôt que par une personne devant un écran. Elle parle d’un contrat entre l’application qui l’offre et les logiciels tiers qui s’en servent.

L’image utile pour un propriétaire d’entreprise : le logiciel de l’autre côté a un comptoir de service. Il accepte certaines demandes, dans un format précis, et refuse le reste. Une intégration, c’est le travail d’écrire ce que votre site demande à ce comptoir, ce qu’il fait de la réponse, et ce qui arrive quand le comptoir est fermé.

Trois mots reviennent dans les échanges avec un fournisseur :

  • Clé d’accès : le laissez-passer que l’autre logiciel donne à votre site. Il se crée dans votre compte.
  • Webhook (ou « notification automatique ») : l’autre logiciel prévient votre site quand quelque chose arrive, par exemple un paiement reçu, au lieu que votre site aille vérifier sans cesse.
  • Synchronisation : les deux côtés gardent la même information, dans un sens ou dans les deux.

Ce qu’on relie, en pratique, sur un site de PME

Voici les liaisons qui reviennent le plus souvent. Pour chacune, la question à vous poser est ce qui se fait aujourd’hui à la main.

Liaison Ce que ça évite Sens de l’échange
Formulaire vers outil de suivi des clients Recopier chaque demande Site vers outil
Boutique vers comptabilité Saisir deux fois chaque vente Site vers comptabilité
Boutique vers inventaire Vendre ce qui n’est plus en stock Dans les deux sens
Site vers infolettre Ajouter les inscrits un par un Site vers infolettre
Réservation vers agenda Les doubles réservations Dans les deux sens
Paiement vers site Confirmer les paiements à la main Paiement vers site

Le sens compte plus qu’on le croit. Une liaison à sens unique est plus simple à bâtir et à surveiller. Une liaison dans les deux sens oblige à décider qui a raison quand les deux côtés ne s’entendent pas : si un client est modifié dans les deux logiciels le même jour, laquelle des deux fiches gagne ?

Avant de commander : sept questions à trancher

Une marche à suivre qui tient sur une page, et qui vaut aussi comme liste à remettre à un fournisseur.

  1. Quelle tâche manuelle veut-on faire disparaître ? Décrivez-la en une phrase, avec qui la fait et à quelle fréquence. Sans cette phrase, l’intégration n’a pas de but mesurable.
  2. Quel logiciel est la référence ? Pour chaque donnée (client, produit, facture), un seul endroit est le maître. L’autre en reçoit une copie.
  3. Existe-t-il déjà un module prêt à installer ? Beaucoup de logiciels en offrent un pour les systèmes de gestion de contenu courants. Un module couvre souvent le cas simple, et son coût de départ est moindre.
  4. Que contiennent les données qui circulent ? Un nom et un courriel sont des renseignements personnels. Savoir lesquels passent d’un logiciel à l’autre fait partie de la décision, et de la liste de ce que votre entreprise doit pouvoir expliquer à un client qui le demande.
  5. Qui possède l’accès ? La clé se crée dans votre compte, pas dans celui du fournisseur. Si la relation prend fin, l’accès reste chez vous.
  6. Que se passe-t-il quand ça échoue ? Le comptoir de l’autre logiciel peut être fermé pendant une mise à jour. La bonne réponse n’est pas « ça n’arrivera pas » : c’est « la demande est mise en attente, on la renvoie, et quelqu’un est averti si elle échoue encore ».
  7. Qui surveille la liaison après la livraison ? Les logiciels changent leurs règles. Une intégration livrée et jamais revue finit par cesser de fonctionner sans bruit.

Module, automatisation ou développement : trois niveaux

Le module prêt à installer. C’est le premier réflexe, et souvent le bon. Il se configure plus qu’il ne se programme. Sa limite : il fait ce que son auteur a prévu, pas plus.

L’outil d’automatisation. Il relie deux logiciels par des règles du genre « quand ceci arrive ici, faire cela là-bas », sans code. Il convient aux liaisons simples et peu nombreuses. Sa limite : un abonnement de plus, et une dépendance de plus à surveiller.

Le développement sur mesure. On écrit la liaison pour votre cas. C’est le choix quand les données doivent être transformées en route, quand plusieurs logiciels sont en jeu, ou quand la règle d’affaires est la vôtre et qu’aucun module ne la connaît. Un bon fournisseur commence par vérifier que les deux premiers niveaux ne suffisent pas, avant de proposer celui-ci.

Les pièges qu’une PME rencontre

  • Le formulaire qui envoie, personne ne reçoit. La liaison fonctionne en test, puis une clé expire. Demandez qu’un échec envoie un courriel à une adresse que quelqu’un lit.
  • Les doublons. Un client existe déjà dans l’outil de suivi, le site en crée un deuxième. La règle d’appariement (courriel, numéro de téléphone) se décide avant, pas après le nettoyage.
  • L’accès au nom du fournisseur. Si la clé est liée à son compte, votre liaison s’arrête avec la relation. Voir la question 5.
  • L’intégration non documentée. Une page de notes (quoi relie quoi, dans quel sens, où est la clé) évite de payer deux fois la découverte quand quelqu’un d’autre reprend le dossier. C’est le même esprit que le cahier des charges d’un site web : les décisions écrites avant le travail.

Quand c’est plus qu’un réglage

Si votre besoin se résume à un module à installer et à configurer, ce billet suffit et vous n’avez pas besoin de nous. Mais si les données doivent être transformées entre deux logiciels, si plusieurs systèmes sont en jeu, ou si aucun module ne connaît votre façon de travailler, le sujet devient un chantier de développement. Le site doit alors être pensé avec la liaison, pas rafistolé après coup. C’est le travail d’une intégration sur mesure, qui commence par la tâche manuelle à retirer et se termine par un suivi des échecs.

Une fois la liaison en place, elle fait partie du site et se surveille comme lui : mises à jour, clés qui expirent, logiciels qui changent leurs règles. C’est ce que couvre un service de maintenance de site web, à confier à quelqu’un de nommé plutôt qu’à personne.

Questions fréquentes

C’est quoi, une API, en mots simples ?

C’est un ensemble de règles qu’un logiciel offre pour que d’autres logiciels lui parlent, sans passer par un écran et un humain. La documentation de Mozilla la décrit comme un contrat entre l’application qui l’offre et les logiciels tiers qui s’en servent. Dans les faits : votre site demande une information ou en envoie une, et l’autre logiciel répond.

Mon site a-t-il besoin d’une intégration sur mesure si j’utilise déjà des modules ?

Pas forcément. Beaucoup de logiciels offrent un module ou un connecteur prêt à installer pour les systèmes de gestion de contenu courants. Le sur mesure devient utile quand aucun module ne couvre votre cas, ou quand le module existant ne fait que la moitié du travail.

Qui doit fournir l’accès à l’autre logiciel ?

Vous. L’accès (une clé ou un compte technique) se crée dans le compte de l’autre logiciel, et ce compte vous appartient. Un fournisseur ne devrait pas créer cet accès à votre nom sans que vous en gardiez le contrôle.

Que se passe-t-il si l’autre logiciel change ou disparaît ?

La liaison peut cesser de fonctionner, parce qu’elle dépend de ce que l’autre logiciel offre. C’est pourquoi une intégration se suit dans le temps, comme le reste du site, et pourquoi il faut savoir qui la surveille.

Les sources

Chaque affirmation de cet article qui porte sur un règlement vient d’un de ces textes. Ils sont publics : allez les lire plutôt que de nous croire sur parole.

Dans la même série

Tous les articles : avant de faire faire son site

Voir à quoi ressemblerait votre site

On monte un aperçu de votre site, avec votre métier et votre région, avant que vous ayez à décider quoi que ce soit. Ça ne coûte rien et ça n’engage à rien.

Voir mon aperçu gratuitDès 1 200 $ + 75 $/mois