Définition
Différence entre API et connecteur, pour un intégrateur
Une API est la porte officielle d'un logiciel ; un connecteur est le programme qui la franchit pour vous. Ce que ça change pour vos devis.
Mis à jour le
Une API (interface de programmation) est la porte officielle d'un logiciel : la liste des opérations qu'il accepte de faire pour un autre programme. Un connecteur est le programme qui franchit cette porte pour vous : il s'authentifie, appelle les bonnes opérations et traduit les données. L'API appartient à l'éditeur du logiciel. Le connecteur appartient à celui qui l'a construit, et c'est lui qui le maintient.
Les définitions, telles qu'un éditeur d'intégration les donne
MuleSoft, éditeur de logiciels d'intégration, distingue trois notions :
| Notion | Définition (MuleSoft) | En pratique |
|---|---|---|
| API | « a way to access information from a system using the exposed system functionality rather than the UI » | Lire ou écrire dans le CRM (logiciel de gestion de la relation client) sans passer par son écran |
| Connecteur | « a software that connects and interacts with your destination system » | Le module tout prêt « HubSpot » ou « Odoo » d'une plateforme |
| Application d'intégration | « the flow of enabling or connecting independently designed applications to work together » | Le flux complet : la conversation crée un prospect, qui déclenche une tâche |
Une image simple : l'API est le guichet, avec ses horaires et ses formulaires. Le connecteur est le coursier qui connaît le guichet et y va à votre place.
Ce que fait un connecteur à votre place
- S'authentifier : obtenir et renouveler le jeton d'accès.
- Faire correspondre les champs : le « statut » de la plateforme devient l'« étape de transaction » du CRM.
- Respecter les limites : chez HubSpot, une application privée sur un compte Free ou Starter est limitée à 100 requêtes par 10 secondes et 250 000 par jour (page des règles d'utilisation, lue le 15/11/2026).
- Gérer les erreurs : réessayer, mettre de côté, alerter.
Pourquoi un connecteur casse alors que l'API marche
C'est la situation la plus fréquente en maintenance, et la plus mal comprise par les clients. Quelques causes :
- le jeton d'accès a expiré ou l'application doit être autorisée de nouveau ;
- un administrateur a renommé ou supprimé un champ personnalisé ;
- un autre flux du client consomme la limite d'appels ;
- l'éditeur retire une version de son API. HubSpot a annoncé le 21/05/2026 que ses API v4 ne seraient plus prises en charge en mars 2027, sans mises à jour ni garantie de stabilité, et recommande la version datée 2026-09.
Dans chacun de ces cas, l'API de l'éditeur fonctionne. C'est le connecteur qu'il faut reprendre.
Ce que ça change pour l'intégrateur
Quand vous ajoutez un assistant IA à un projet, posez trois questions avant de chiffrer :
- Le connecteur existe-t-il déjà ? Dans la plateforme d'assistants, dans l'outil d'automatisation, ou sous forme de serveur MCP de l'éditeur (Model Context Protocol, un standard qui relie un assistant IA à des outils) (voir Serveurs MCP des outils métier).
- Qui le maintient ? Si c'est vous, la maintenance entre dans votre ligne mensuelle (voir Maintenance).
- Couvre-t-il les champs du client ? Un connecteur standard ignore souvent les champs personnalisés, qui sont justement ceux où vit le métier.
Une API se documente une fois ; un connecteur se surveille tout le temps. C'est ce suivi qui a de la valeur pour votre client.
Questions fréquentes
Un connecteur peut-il tomber en panne alors que l'API fonctionne ?
Oui. Un jeton d'accès expiré, un champ renommé chez le client ou une limite d'appels atteinte cassent le connecteur sans que l'API soit en cause.
Qui maintient le connecteur entre un assistant IA et un CRM ?
Celui qui l'a construit ou qui le fournit : l'éditeur de la plateforme, l'outil d'automatisation ou l'intégrateur. C'est à écrire noir sur blanc dans le projet.
Sources
Pages consultées pour écrire cet article :