API et intégrations

Une API (application programming interface, interface de programmation) est un ensemble de règles et de possibilités à l'intérieur d'un programme, par lesquelles un autre programme peut interagir avec lui, par opposition à une interface humaine. C'est un « contrat » entre le programme qui propose l'API et des programmes ou appareils tiers (MDN). Une intégration est la liaison entre deux systèmes par un tel contrat, afin qu'ils échangent des données sans transfert manuel.

En clair

Quand vous cherchez un point de retrait du transporteur sur le site d'une boutique, le site ne fouille pas dans la base de données du transporteur. Il envoie une requête à une « fenêtre » spéciale (l'API) et reçoit une réponse : une liste de villes et de points de retrait. De la même façon, le site peut transmettre une commande à un CRM, et un système comptable peut renvoyer les niveaux de stock.

Une intégration est le travail qui utilise une API : quelqu'un configure quelles données envoyer, quand et dans quel sens.

Comment les systèmes échangent des données

Il existe plusieurs façons. Toutes se rencontrent dans une boutique.

• Requête par requête (API). Un système appelle lui-même un autre : « donne-moi le stock », « crée un bordereau d'expédition ». Les règles de la requête sont décrites dans la documentation de l'API. Il existe des normes pour décrire les API : la spécification OpenAPI en est à la version 3.2.1 du 10 septembre 2026 (OpenAPI Initiative).
• Webhook. Un système prévient lui-même un autre quand quelque chose s'est produit : une commande a été payée, un statut a changé. Selon Wikipédia, ce sont des « rappels HTTP définis par l'utilisateur » : lors d'un événement, la source envoie une requête à une adresse que vous avez fixée, et le destinataire n'a pas besoin d'interroger le système en permanence (Wikipedia, Webhook).
• Fichiers. Export d'un tableur ou de XML, comme dans les flux produits. Simple, mais lent et sans mise à jour instantanée.
• Module ou connecteur prêt à l'emploi. L'éditeur a déjà construit un lien entre deux services courants ; vous l'activez et saisissez une clé.

Pourquoi une boutique en a besoin

Sans intégrations, les données entre systèmes sont déplacées à la main : commandes du site vers le CRM, stock vers le système comptable, bordereaux vers le service de livraison. C'est lent et source d'erreurs.

Liens typiques dans une boutique :

• site et service de paiement : paiement et statut (moyens de paiement) ;
• site et service de livraison : bordereaux, statuts, paiement à la livraison ;
• site, CRM et OMS ou WMS : commandes, stock, statuts ;
• catalogue et PIM, marketplaces.

Quand vous en avez besoin

Quand vous constatez que quelqu'un déplace chaque jour des données entre des systèmes, ou que le stock du site diverge de celui de l'entrepôt.

Quand c'est trop tôt

Quand il y a deux ou trois systèmes et que l'échange représente quelques commandes par jour. Un module prêt à l'emploi, voire un transfert manuel, suffit alors. Ne construisez pas un lien complexe pour une commande dont vous n'avez pas encore besoin.

Sécurité et fiabilité

• Les clés d'API sont des « mots de passe » entre systèmes. Ne les faites pas circuler dans les messageries et ne les publiez pas.
• Les webhooks doivent être vérifiés : Wikipédia énumère les moyens courants d'authentifier les requêtes entrantes (un secret partagé, une signature numérique, une signature HMAC dans un en-tête) et la vérification de l'heure de la requête contre les rejeux (Wikipedia, Webhook).
• Que se passe-t-il en cas d'échec : l'intégration doit réessayer l'envoi et afficher les erreurs, sinon une commande « reste bloquée » sans qu'on le remarque.
• Qui est responsable : l'éditeur du service ou votre intégrateur. Mieux vaut le savoir avant le lancement.

Erreurs fréquentes

• Une intégration à sens unique alors que les données changent dans les deux systèmes : des écarts apparaissent.
• Pas de clé de commande unique entre les systèmes.
• Personne ne surveille les erreurs d'échange.
• Un système fermé sans API : plus tard, rien ne pourra s'y connecter. Avant de choisir un service, demandez s'il existe une API ouverte et un export des données (SaaS).

FAQ

Qu'est-ce qu'une API en clair ? Un moyen pour un programme de demander à un autre des données ou une action selon des règles décrites à l'avance.

Qu'est-ce qu'une intégration dans une boutique en ligne ? Une liaison automatique entre des systèmes : le site transmet une commande au CRM ou à la comptabilité, le service de livraison renvoie un statut.

En quoi un webhook diffère-t-il d'une API ? Avec une API, vous demandez vous-même les données. Avec un webhook, le système vous prévient quand quelque chose s'est produit.

A-t-on besoin d'un développeur pour une intégration ? Pour un module prêt à l'emploi, en général non ; pour un lien non standard, oui. Cela dépend des systèmes que vous connectez.

Termes associés

• CRM
• Headless commerce
• Système PIM
• Flux produits

Sources

• MDN, API (Glossary) — developer.mozilla.org/en-US/docs/Glossary/API
• Wikipedia, Webhook — en.wikipedia.org/wiki/Webhook
• OpenAPI Initiative, OpenAPI Specification v3.2.1 (10.09.2026) — spec.openapis.org/oas/latest.html