Sites webPar Xavier Peich

Faire parler vos logiciels entre eux : ce qu'une intégration API règle, et ce qu'elle ne règle pas

Une API, c'est une porte qu'un logiciel ouvre à un autre. Connecteur, Zapier ou sur mesure : comment choisir, et ce qui casse après la mise en service.

Faire parler vos logiciels entre eux : ce qu'une intégration API règle, et ce qu'elle ne règle pas

Dans bien des PME, un nouveau client existe trois fois. Quelqu'un l'entre dans le CRM après le premier appel, le retape dans l'outil de facturation à la signature, puis une troisième fois dans l'agenda pour le premier rendez-vous. Ça prend quelques minutes, et personne ne s'en plaint. Relier ces outils est pourtant l'un des projets les plus rentables qu'une PME puisse confier à un développeur de logiciel sur mesure, ou à personne, quand le lien existe déjà.

C'est aussi le projet dont on vend le plus mal la suite. Une intégration est un petit logiciel qui dépend de deux fournisseurs, et aucun des deux ne vous consulte avant de changer ses règles. Voici ce qu'est une API pour un propriétaire d'entreprise, les trois façons de relier deux logiciels, et ce qui casse une fois que tout fonctionne.

La réponse courte, pour les pressés

Une intégration API relie deux logiciels pour qu'une donnée saisie dans l'un apparaisse dans l'autre sans qu'on la retape. Une API est une porte que l'éditeur d'un logiciel publie pour les autres programmes, avec ses règles : qui peut entrer, combien de fois par minute, et quelles données passent. Une PME a trois options. Si un connecteur natif existe entre ses deux outils, elle l'active. Si le flux est simple et linéaire, un outil de liaison comme Zapier ou Make suffit. Une intégration sur mesure se justifie quand le volume, les règles d'affaires ou un logiciel sans connecteur dépassent ces options. Dans les trois cas, le vrai coût arrive après la mise en service : des jetons d'accès qui expirent, des versions d'API retirées, des plafonds d'appels, des conditions qui changent chez le fournisseur et des synchronisations qui échouent en silence. Une intégration sans responsable ni alerte finit par laisser vos systèmes diverger.

Le vrai coût de la double saisie

Les minutes passées à recopier se voient. Le coût qui compte ne se voit pas : trois copies d'un même client sont trois versions de la vérité. Le jour où le client déménage, l'adresse change dans le CRM parce que c'est là qu'il a appelé. L'outil de facturation garde l'ancienne, et la prochaine facture part au mauvais endroit. Personne n'a fait d'erreur; le système en a fabriqué une.

La double saisie crée aussi une dépendance discrète. Souvent, une seule personne sait quel logiciel fait foi pour quelle donnée. Quand elle part en vacances, ce savoir part avec elle.

On ne vous donnera pas de chiffre d'heures économisées : il dépend entièrement de votre volume, et ceux qui circulent viennent de vendeurs d'outils d'intégration. Faites le calcul vous-même. Combien de fiches par semaine, recopiées combien de fois, et combien d'erreurs par trimestre viennent d'une copie qui n'a pas suivi? Le but d'une intégration est qu'il n'existe qu'une source par donnée, et que les autres logiciels la lisent au lieu de la recopier. Le temps gagné vient en prime.

Une API, expliquée sans jargon

API veut dire interface de programmation d'application. En termes de propriétaire : c'est une porte que l'éditeur d'un logiciel ouvre à d'autres programmes. Elle est publiée et documentée, et l'éditeur y affiche trois règles.

Qui peut frapper. Le titulaire du compte donne son accord une fois, et le programme reçoit un jeton, une sorte de laissez-passer temporaire que la porte vérifie à chaque appel. Pas de jeton valide, pas d'entrée.

Combien de fois. Chaque porte a un débit maximal. Pour QuickBooks en ligne, Intuit fixe la limite à 500 requêtes par minute par entreprise, et à 10 par seconde par entreprise et par application. Au-delà, la porte répond par une erreur 429, « trop de requêtes », et Intuit demande d'attendre 60 secondes avant de réessayer.

Ce qui passe. L'éditeur décide quelles données il expose, en lecture et en écriture. Ce qu'il n'expose pas ne s'intègre pas, quel que soit votre budget.

La conséquence pratique tient en une phrase : une intégration ne sera jamais meilleure que la porte. Avant de demander « peut-on relier X et Y? », demandez ce que les API de X et de Y laissent passer. Et quand vous magasinez un logiciel, ouvrez sa page de forfaits avant de signer : si l'accès à l'API n'y figure qu'au palier supérieur, ou pas du tout, l'intégration vient de changer de prix.

Trois cas, du moins cher au plus cher

Le connecteur natif existe : activez-le. Souvent, les deux éditeurs ont déjà construit le lien. Cherchez dans les paramètres de chaque outil une page Intégrations, Applications ou Marketplace. On l'active, on associe les champs, on teste avec une seule fiche. C'est l'option la moins chère, et souvent la bonne. Sa limite : le connecteur synchronise ce que l'éditeur a choisi, dans le sens qu'il a choisi, et vous ne pouvez pas y ajouter votre règle. Vérifiez aussi qui l'entretient : l'éditeur lui-même, ou une tierce partie inscrite dans sa boutique d'applications.

Un outil de liaison suffit. Zapier, Make ou, dans l'univers Microsoft, Power Automate passent par les mêmes portes : un déclencheur, puis des étapes. Pour un flux linéaire, à volume modeste, avec quelqu'un à l'interne pour l'entretenir, c'est le bon outil. On a détaillé où passe la limite dans notre comparaison entre no-code et sur mesure et dans l'article sur Power Automate.

Il faut une intégration sur mesure. Trois signaux. Le volume d'abord : importer des années d'historique se heurte aux plafonds, et QuickBooks en ligne ne renvoie au plus que 1 000 fiches par requête, ce qui oblige à paginer et à doser le rythme. Les règles ensuite : ce client existe-t-il déjà sous un autre nom? Quel système gagne quand deux fiches se contredisent? Enfin, le logiciel qui a une API mais aucun connecteur, fréquent dans les logiciels de métier. C'est la « mince couche » décrite dans notre article sur le sur mesure ou le SaaS : on garde ses abonnements et on construit seulement ce qui les relie, parfois jusqu'à un portail où vos clients consultent leur dossier.

Chez Peich, on construit ce genre d'intégrations : l'article sur l'agent IA en comptabilité en décrit une, notre connecteur entre QuickBooks et les assistants IA. Les assistants frappent d'ailleurs aux mêmes portes, à travers le protocole MCP.

Reste le logiciel sans API du tout : on automatise parfois un export de fichier, et parfois la bonne réponse est d'en changer.

Ce qui casse avec le temps

Le jour de la mise en service, une intégration fonctionne. Ses pannes arrivent des mois plus tard, et elles viennent presque toujours de l'extérieur.

Les jetons expirent. Pour QuickBooks en ligne, le jeton d'accès ne vaut qu'une heure, et le jeton qui sert à le renouveler change régulièrement : dès qu'Intuit en remet un nouveau, l'ancien cesse de fonctionner, et l'intégration doit toujours conserver le dernier reçu. Chez Squarespace, le jeton de renouvellement expire après sept jours et ne sert qu'une fois. Chez Google, une application restée au statut « Testing » reçoit des jetons de renouvellement qui expirent après sept jours. Chez Microsoft, le secret client d'une application inscrite dans Entra ne peut pas durer plus de 24 mois, et Microsoft recommande moins de 12. L'intégration s'arrête alors à une date anniversaire que personne n'a notée.

Les versions sont retirées. Shopify publie une nouvelle version de son API chaque trimestre et soutient chacune au moins 12 mois avant de la retirer. Une application qui appelle une version retirée ne reçoit pas d'erreur : Shopify lui répond avec la plus ancienne version encore accessible. Rien ne plante. Les réponses changent de forme, et c'est souvent pire.

Le fournisseur change ses conditions. En mai 2025, Intuit a annoncé un programme de partenaires, lancé le 28 juillet 2025 aux États-Unis, avec un calendrier distinct pour les autres pays. Il classe les appels à l'API comptable en deux catégories. Écrire dans QuickBooks, créer une facture ou un client, reste gratuit et illimité. Lire (comptes, rapports, requêtes) est désormais compté : le palier gratuit en inclut 500 000 par mois par espace de travail, et au-delà, les appels sont refusés. Pour l'intégration d'une PME, ce plafond est loin. Mais la leçon dépasse le chiffre : c'est l'éditeur qui tient la porte, et il a rendu l'entrée des données gratuite et leur sortie comptée.

La synchronisation échoue en silence. Beaucoup d'intégrations reçoivent des avis automatiques, les webhooks, quand quelque chose change chez le fournisseur. Si votre serveur ne répond pas, Shopify réessaie jusqu'à huit fois en quatre heures, puis supprime l'abonnement. Stripe réessaie pendant au plus trois jours. Ensuite, plus rien n'arrive, et aucun logiciel ne vous prévient que les chiffres ont cessé de concorder. Vous l'apprenez à la fin du mois, quand le rapport des ventes et la comptabilité ne disent plus la même chose.

Ce qu'une intégration bien faite prévoit dès le départ

Aucune de ces pannes ne s'évite pour de bon. Ce qu'on choisit, c'est le moment où on la découvre : le jour même, ou à la fin du mois. Une intégration bien faite arrive avec six pièces.

Un responsable nommé. Une personne sait que l'intégration existe, ce qu'elle synchronise et à qui téléphoner quand elle s'arrête.

Des accès au nom de l'entreprise. L'application inscrite chez le fournisseur et les jetons appartiennent à un compte de l'entreprise, pas à l'employé qui a fait la configuration. Les dates d'expiration connues vont dans un calendrier.

Une alerte à la première panne. Un journal d'erreurs que personne ne lit ne sert à rien. Il faut un courriel ou un message à un humain dès le premier échec, pas après le huitième.

Un contrôle de concordance. Une fois par semaine, l'intégration compare elle-même ses deux côtés : nombre de clients, total des factures du mois. Un écart déclenche une alerte avant que votre comptable le trouve.

Une version épinglée et une veille. L'intégration appelle une version précise de l'API, et quelqu'un est inscrit au journal des changements du fournisseur, comme Shopify le recommande.

Une règle de vérité par donnée. L'adresse vient du CRM, le solde vient de la comptabilité, et c'est écrit quelque part.

Par où commencer

Faites la liste des données que votre équipe tape plus d'une fois, et des logiciels entre lesquels elles voyagent. Pour chaque paire, cherchez d'abord un connecteur natif, puis un outil de liaison. N'envisagez le sur mesure qu'ensuite, et demandez à qui le propose comment il compte gérer les jetons, les versions et les alertes. S'il n'a pas de réponse, il vous vend la partie facile.

C'est une conversation qu'on a souvent : quelles paires relier, avec quel outil, et qui s'occupera de la suite. On vous dira aussi quand un connecteur déjà payé fait le travail.

→ Parlons des logiciels que votre équipe recopie

Xavier PeichÉcrit parXavier Peich