API, définition simple : une porte entre vos logiciels, et trois décisions de dirigeant

Une API, en définition simple, c’est une porte d’entrée qu’un logiciel ouvre pour que d’autres logiciels puissent lui demander ou lui envoyer des données, sans passer par l’écran. Concrètement, votre logiciel de facturation peut transmettre ses factures à votre fichier clients sans que personne ne les recopie à la main.

La CNIL, dans son glossaire, dit la même chose : une API est « une interface logicielle qui permet de “connecter” un logiciel ou un service à un autre logiciel ou service afin d’échanger des données et des fonctionnalités » (CNIL, définition de l’API, page non datée, version du 19 septembre 2026).

Ma position, pour un dirigeant de PME : une API se décide au moment d’acheter un logiciel, pas au moment de le brancher. Vous n’avez pas besoin de savoir comment elle fonctionne à l’intérieur. En revanche, elle vous impose trois décisions, et elles vous reviennent :

1. Avant d’acheter ou de renouveler un logiciel, posez la question : « a-t-il une API, et à partir de quel forfait ? » Chez Pennylane, il faut le forfait Essential ou supérieur (documentation de l’éditeur, relevée le 15 octobre 2026, comme les autres exemples de cet article).
2. Qui a le droit d’ouvrir la porte ? Un administrateur chez Pennylane, un super administrateur chez HubSpot.
3. Que laissez-vous passer ? Lecture seule, ou lecture et écriture, une date d’expiration, et une clé qui ne voyage jamais par mail.

Le branchement lui-même peut passer par un outil d’automatisation comme n8n, qui appelle les API à votre place : pour les logiciels qu’il connaît déjà, on remplit un formulaire plutôt que de programmer.

Qu’est-ce qu’une API, en une phrase ?

Une API est un ensemble de règles qu’un logiciel met à disposition pour qu’un autre logiciel travaille avec lui automatiquement, sans passer par l’écran. La documentation de référence MDN, glossaire « API », modifiée le 21 octobre 2025, la décrit comme un moyen « d’interagir avec celui-ci de manière automatisée (plutôt que de passer par une interface utilisateur) », et la compare à « un contrat simple » entre le logiciel qui la propose et des logiciels tiers.

Le sigle vient de l’anglais Application Programming Interface, interface de programmation d’application. L’« interface utilisateur », ce sont les écrans et les boutons que vous utilisez. L’API, c’est l’équivalent pour un autre logiciel : une porte par laquelle il entre, avec des règles écrites sur ce qu’il a le droit de demander et d’envoyer.

À quoi sert une API dans une PME ? Moins de double saisie

Prenons un artisan qui saisit deux fois chaque devis : une fois dans son logiciel de devis, une fois dans son outil de comptabilité. C’est un scénario imaginé, pour illustrer. Si les deux logiciels ont une API, un devis accepté peut passer de l’un à l’autre sans ressaisie.

La même logique vaut pour d’autres liaisons du quotidien, par exemple :

• la facturation qui alimente la comptabilité ;
• le CRM (le fichier où vous suivez vos clients et prospects) qui récupère les factures ou les paiements ;
• l’agenda qui crée une fiche contact quand un rendez-vous est pris ;
• le site dont le formulaire de contact arrive directement dans le CRM.

Une condition à chaque fois : que chaque logiciel ait une API ouverte, et que votre forfait y donne accès. La CNIL le rappelle dans la même définition : les API « peuvent être gratuites ou payantes ».

API ou webhook : la différence en deux phrases

Avec une API, c’est votre outil qui va chercher l’information quand il en a besoin, comme on décroche le téléphone pour poser une question. Avec un webhook, c’est le logiciel qui prévient tout seul, en envoyant un message à une adresse dès qu’un événement se produit (une facture payée, un formulaire rempli) : tout est détaillé dans le pas-à-pas webhook avec n8n.

Quelle est la différence entre une API et l’IA ?

L’IA, c’est le moteur : le modèle qui lit un texte et en rédige un. L’API, c’est la porte d’accès à ce moteur pour un autre logiciel. La documentation d’Anthropic, l’éditeur de Claude, le dit en ces termes (traduit de l’anglais) : l’API de Claude est une API REST qui « fournit un accès programmatique aux modèles Claude ». « Programmatique » veut dire qu’un programme s’adresse au modèle directement, sans fenêtre de discussion.

Quand vous tapez une question dans une fenêtre de discussion, vous passez par l’écran. Quand un logiciel envoie un texte au modèle et récupère la réponse pour la ranger ailleurs, il passe par l’API. Dans les deux cas, c’est le modèle d’IA qui répond ; ce qui change, c’est la porte.

Bonne nouvelle pour un dirigeant : cette porte fonctionne comme celle de vos logiciels de gestion. D’après la présentation de l’API Claude :

• il faut un compte sur la console de l’éditeur et une clé d’API pour l’utiliser ;
• à la création de chaque clé, on choisit son type et sa date d’expiration ;
• l’usage est encadré par des plafonds (de débit et de dépense) organisés par paliers, et une organisation peut passer à un palier supérieur avec le temps.

Une clé, des droits limités, des plafonds : on retrouve la même logique dans vos logiciels de gestion.

Où trouver l’accès API d’un logiciel que vous utilisez déjà (comptabilité, CRM) ?

Il n’existe pas d’emplacement commun à tous les logiciels : c’est la documentation de l’éditeur qui le donne. Deux exemples. Chez Pennylane (comptabilité), l’accès se crée dans les paramètres, rubrique Connectivité, puis Développeurs. Chez HubSpot (CRM), il passe par le menu Développement et la création d’une application dite « privée », réservée à votre compte.

Voici les chemins tels que les éditeurs les décrivent dans leur documentation, rédigée en anglais (le nom anglais des menus est entre parenthèses) :

1. Pennylane (guide de création du jeton d’API Pennylane, mis à jour le 30 janvier 2026) : dans la section Gestion (Management), ouvrez Paramètres (Settings), puis Connectivité (Connectivity), puis Développeurs (Developers), et cliquez sur le bouton de création de jeton (Generate an API Token).
2. HubSpot (documentation HubSpot sur les applications privées anciennes, mise à jour le 7 août 2026) : menu Développement (Development), rubrique des applications anciennes (Legacy apps), bouton de création (Create legacy app), choix du type privé (Private). Le jeton s’affiche ensuite dans l’onglet Auth, par le bouton Show token. HubSpot range désormais ces applications privées parmi ses applications anciennes : le chemin peut changer, vérifiez sa documentation avant un nouveau branchement.

Un mot de vocabulaire : Pennylane parle de « jeton » (token), d’autres éditeurs de « clé API ». Pour vous, c’est la même chose : le code secret qui ouvre la porte.

Vérifier quel forfait donne accès à l’API avant d’acheter

L’accès à l’API peut dépendre du forfait, et c’est dans la documentation de l’éditeur que la condition est écrite. Pennylane indique que si l’entreprise est au forfait Starter, il faut passer au forfait Essential ou supérieur pour créer un jeton.

Chez HubSpot, la page ne fixe pas de forfait minimum pour créer l’accès, mais le nombre d’appels (une demande envoyée par l’API) dépend de l’abonnement, d’après la même documentation :

• Free et Starter : 100 appels toutes les 10 secondes par application, 250 000 par jour pour le compte ;
• Professional : 190 appels toutes les 10 secondes par application, 625 000 par jour ;
• Enterprise : 190 appels toutes les 10 secondes par application, 1 000 000 par jour, avec une extension payante possible.

Posez quatre questions par écrit à l’éditeur avant de signer ou de renouveler : y a-t-il une API, à partir de quel forfait, en lecture seule ou aussi en écriture, et avec quelles limites d’appels. Si l’éditeur ne sait pas répondre par écrit à l’une d’elles, comptez qu’il faudra un contournement, donc du temps.

Comment activer l’API d’un logiciel : qui peut le faire, et avec quelles précautions ?

Chez ces deux éditeurs, seul un profil administrateur peut ouvrir l’accès. Chez Pennylane, ce sont les rôles avec accès administrateur : dirigeant (Executive), comptable interne ou comptable externe. Chez HubSpot, il faut être super administrateur. À la création, vous choisissez ce que la clé a le droit de faire : lecture seule, ou lecture et écriture chez Pennylane, droit par droit chez HubSpot.

Les précautions, d’après la documentation des deux éditeurs :

• Commencer en lecture seule. Chez Pennylane, la lecture seule sert à récupérer des données, la lecture et écriture à en créer ou en modifier. Je recommande de commencer en lecture seule et de n’ouvrir l’écriture que pour l’usage qui l’exige.
• Une date d’expiration. Pennylane propose 1 mois, 6 mois, 12 mois ou illimité. Choisissez une durée limitée, quitte à renouveler.
• Une clé par usage. Une entreprise peut avoir plusieurs jetons chez Pennylane, chacun avec ses droits et sa date d’expiration ; HubSpot accepte jusqu’à 20 applications privées par compte. Une clé par liaison permet d’en couper une sans arrêter les autres.
• Copier la clé tout de suite. Chez Pennylane, le jeton ne s’affiche qu’une seule fois et n’est pas conservé : perdu, il faut en créer un nouveau. Chez HubSpot, en revanche, le jeton reste affichable depuis l’onglet Auth, auquel seuls les super administrateurs ont accès : raison de plus pour réserver ce rôle à très peu de personnes.
• Changer la clé régulièrement. HubSpot recommande de remplacer le jeton tous les six mois, même sans menace ; le remplacement programmé fait expirer l’ancien jeton au bout de 7 jours.

Une clé API, c’est quoi, et pourquoi elle ne part jamais par mail

Une clé API est un long code secret qui prouve au logiciel que la demande vient de quelqu’un d’autorisé. HubSpot le formule ainsi : vous autorisez ce que chaque application peut demander ou modifier dans votre compte, ce qui génère un jeton d’accès propre à cette application. Celui qui détient la clé agit donc avec tous les droits que vous lui avez donnés.

C’est pour ça que je déconseille de la coller dans un mail : un mail se transfère, s’archive, se retrouve dans plusieurs boîtes, et vous ne pouvez plus le reprendre. La clé se colle directement dans l’outil qui va s’en servir, à l’endroit prévu pour les identifiants. Pour n8n, la marche à suivre est dans l’article sur le rangement des clés dans n8n.

Si une clé est déjà partie par mail, coupez-la puis remplacez-la. Chez Pennylane, supprimez l’ancien jeton avec le bouton Delete placé à côté de lui : d’après la documentation, il perd aussitôt l’accès à l’API ; générez-en ensuite un nouveau. Chez HubSpot, le remplacement immédiat crée un nouveau jeton et fait expirer l’ancien.

Comment relier deux logiciels par leur API quand on n’est pas développeur ?

Avec un outil d’automatisation comme n8n, qui enchaîne des tâches entre logiciels et appelle les API à votre place. D’après la documentation n8n du bloc HTTP Request, ce bloc permet d’interroger « n’importe quelle application ou service doté d’une API REST » (traduit de l’anglais). Quand n8n connaît déjà le logiciel, il recommande ses identifiants tout prêts ; sinon, la connexion se règle à la main.

« API REST » désigne une API qu’on interroge par des adresses web, comme l’API de Claude, que sa documentation présente ainsi. Deux points de la documentation de n8n rendent la chose plus accessible :

1. Les identifiants prédéfinis. Pour les logiciels que n8n connaît, vous collez votre clé dans un formulaire prévu pour, et n8n gère le reste.
2. L’import d’un exemple. Quand la documentation d’un logiciel donne un exemple écrit pour curl (un outil qui sert à envoyer des données vers des adresses web), vous collez cet exemple dans le bloc HTTP Request, et n8n remplit lui-même les champs de la requête.

Il reste à lire la documentation de l’éditeur et à tester la connexion sur un cas réel, ou à vous faire accompagner pour cette partie.

Reprenons l’artisan du scénario imaginé plus haut. Son automatisation tiendrait en trois étapes : un devis passe au statut « accepté », n8n lit ce devis par l’API du logiciel de devis, puis l’écrit par l’API de la comptabilité. À condition, encore une fois, que les deux logiciels aient une API ouverte à son forfait.

n8n a aussi sa propre API : d’après sa documentation, elle permet de faire par programme une bonne partie de ce qu’on fait à l’écran dans n8n (traduit de l’anglais). C’est un autre sujet, traité dans le guide de l’API n8n pour PME.

Si vous ressaisissez chaque semaine les mêmes données d’un logiciel à l’autre, c’est le point de départ d’une automatisation n8n branchée sur les API de vos propres outils : on identifie d’abord les tâches répétitives et les ruptures entre vos outils, puis je connecte vos outils via leurs API et je teste chaque scénario sur vos cas réels avant toute mise en service. Si vous préférez que votre équipe apprenne à le faire, la formation agent IA et automatisation n8n y consacre son deuxième jour : construire dans n8n et poser les garde-fous (deux jours, soit 14 heures).

Sources

• CNIL, « Interface de programmation d’application (API) », page non datée, version du 19 septembre 2026.
• MDN Web Docs (Mozilla), « API », glossaire, modifiée le 21 octobre 2025.
• Anthropic, « API overview », documentation de l’API Claude, page non datée, lue le 15 octobre 2026.
• Pennylane, « Generating my API token », mise à jour le 30 janvier 2026, lue le 15 octobre 2026.
• HubSpot, « Legacy private apps », mise à jour le 7 août 2026, lue le 15 octobre 2026.
• n8n, « HTTP Request node », page non datée, lue le 15 octobre 2026.
• n8n, « n8n API », page non datée, lue le 15 octobre 2026.