Une API, c'est quoi ? Relier vos outils entre eux, expliqué simplement

Une API est une porte qu'un logiciel ouvre pour que d'autres programmes puissent lui parler. Votre outil y envoie une demande précise, comme « donne-moi les commandes de ce client », et le logiciel renvoie une réponse rangée que votre outil sait lire.

C'est par une API qu'un outil fait maison lit les commandes d'une boutique Shopify, envoie un e-mail depuis Gmail ou récupère le taux de change du jour. Cet article s'adresse aux personnes qui n'ont jamais programmé et qui entendent ce mot dès qu'il s'agit de relier deux logiciels.

À la fin, vous saurez ce qu'une API permet, où trouver celles qui sont gratuites, comment faire lire leur mode d'emploi par Claude Code et où ranger la clé qui y donne accès.

Qu'est-ce qu'une API, expliqué simplement ?

API veut dire Application Programming Interface, en français interface de programmation. Un logiciel a des écrans et des boutons pour les humains. Il peut aussi avoir une API, c'est-à-dire une entrée prévue pour les programmes.

Pensez à un guichet de mairie. Vous remplissez le formulaire prévu, vous le tendez à l'agent, et il vous rend le document demandé. Les dossiers restent derrière le comptoir. Une API fonctionne de la même façon, avec trois éléments :

• L'adresse : chaque demande possible a son adresse web, un peu comme une page.
• La demande : ce que l'on veut, avec ses précisions, par exemple le numéro du client ou la date.
• La réponse : les informations demandées, rangées en champs. Le format le plus courant s'appelle JSON, un texte organisé en étiquettes et en valeurs, comme « ville : Lyon ».

Certaines demandes lisent, comme afficher une commande. D'autres écrivent : créer un client, envoyer un e-mail. La documentation de l'API, publiée sur le site du logiciel, liste toutes les demandes permises. C'est son mode d'emploi.

Claude Code écrit ces demandes à votre place : vous décrivez en français l'écran voulu, et Claude écrit le code qui interroge l'API. Vous choisissez la bonne API, puis vous vérifiez le résultat à l'écran.

À quoi sert une API dans une petite entreprise ?

Une API fait circuler une information d'un logiciel à un autre sans la recopier à la main. La plupart des services que vous utilisez déjà en ont une : Gmail, Google Sheets, Notion, Slack, WhatsApp, Shopify, Instagram, Facebook, Qonto, Pennylane, Calendly. Stripe encaisse les paiements par carte par son API, et Resend envoie ainsi les e-mails depuis votre domaine.

Rugstar, une marque de tapis, a construit son CRM avec Claude Code. Il affiche les relances avec le fil des e-mails Gmail de chaque client. Il génère aussi le catalogue et le dossier de presse en PDF à partir des produits de la boutique Shopify, comme le décrit l'article sur le catalogue PDF automatique depuis Shopify. Ces deux fonctions passent par les API de Gmail et de Shopify.

Une API sert à aller chercher une information quand l'écran s'affiche, ou à envoyer une information quand vous cliquez, comme pour générer des fiches produits avec l'IA et les envoyer sur Shopify.

Certains services préviennent aussi votre outil quand quelque chose change, par exemple à chaque commande. Ce message automatique s'appelle un webhook, expliqué dans Un webhook, c'est quoi ?. Pour relier vos services sans abonnement à une plateforme d'automatisation, lisez aussi l'alternative à Zapier et Make.

Trois exemples d'API branchées dans un outil maison

Le taux de change du jour dans un calcul de prix

Un moteur de prix, comme celui de Rugstar, construit à partir du fichier Excel de calcul des coûts, a besoin d'un taux de change dès qu'un fournisseur facture en dollars et que la marge se calcule en euros.

La Banque centrale européenne publie des taux de référence de l'euro face aux principales devises. Ils sont mis à jour vers 16 h, heure d'Europe centrale, chaque jour ouvré, sauf les jours de fermeture du système de paiement européen TARGET. Ils se téléchargent librement, dans des formats lisibles par un programme.

Dans l'écran de calcul, le champ Taux €/$ se remplit seul, avec la date du taux juste dessous. Un bouton Figer ce taux garde la valeur dans le scénario, pour que le prix ne bouge plus une fois le devis envoyé.

La BCE précise que ces taux sont publiés à titre d'information et déconseille de s'en servir pour des transactions. Le taux appliqué à un vrai virement reste celui de votre banque.

Les commandes Shopify dans la fiche client

Quand un client appelle, vous voulez voir ses achats sans ouvrir l'administration Shopify. L'API de Shopify permet à votre outil de lire les commandes de la boutique et de retrouver celles de ce client.

Dans la fiche client, une partie Commandes boutique affiche un tableau à quatre colonnes : Numéro, Date, Montant, État (payée, expédiée, remboursée). Un clic sur une ligne ouvre la commande dans Shopify.

Pour obtenir l'accès, on crée une application privée pour sa boutique, avec le seul droit de lire les commandes et les clients. La marche à suivre est dans Créer une app Shopify privée.

L'adresse complétée pendant la saisie

La Base Adresse Nationale recense les adresses françaises. Son API, désormais servie par la Géoplateforme de l'IGN, propose une autocomplétion : vous tapez le début d'une adresse, elle renvoie les adresses qui correspondent. Elle est ouverte d'accès, sans clé.

Dans le formulaire Nouveau client, vous tapez le début de la rue, et des suggestions apparaissent sous le champ. Vous choisissez la bonne ligne, et les champs Rue, Code postal et Ville se remplissent avec les données de la base officielle.

L'API Recherche d'entreprises, publiée par l'État, retrouve de la même façon une entreprise par son nom, son adresse ou son numéro SIREN, sans inscription. Pour un client professionnel, vous choisissez la bonne entreprise dans la liste, et son SIREN s'ajoute à la fiche.

Quelles API gratuites sont utiles à une entreprise française ?

Le catalogue api.gouv.fr recense les API publiques de l'État. Ces quatre API ouvertes servent dans beaucoup d'outils de gestion :

La demande à Claude Code suit toujours le même modèle : nommez l'API, dites quel écran s'en sert, puis décrivez ce qui s'affiche.

Comment lire la documentation d'une API avec Claude ?

La documentation d'une API est souvent en anglais et écrite pour des développeurs. Claude Code la lit et vous la résume. Cherchez d'abord quatre réponses :

1. 1L'API est-elle ouverte à votre abonnement ? Certains logiciels la réservent à leurs offres supérieures. Leur page de tarifs le dit.
2. 2Comment entre-t-on ? Le plus souvent avec une clé. Parfois, on autorise une connexion, comme avec un compte Google.
3. 3Quelles limites s'appliquent ? La plupart des API fixent un nombre de demandes permises par minute ou par jour.
4. 4L'API prévient-elle votre outil ? Avec des webhooks, votre outil est averti de chaque changement. Sinon, il va demander à intervalles réguliers, par une tâche planifiée chaque jour.

Demandez d'abord une explication, sans rien construire :

Ensuite, demandez une page de test en lecture seule, qui affiche par exemple le nombre de réservations d'hier sans rien modifier. Comparez ce chiffre avec l'écran du logiciel sur plusieurs journées.

Claude peut aussi se servir lui-même de certains services pendant une conversation, par des connecteurs appelés MCP, présentés dans MCP Claude, c'est quoi ?.

Qu'est-ce qu'une clé d'API, et où la ranger ?

Une clé d'API est un long code secret que le service vous donne pour prouver que la demande vient bien de vous. Quiconque la possède peut agir en votre nom, dans la limite de ses droits. Elle se garde comme un mot de passe.

• Hors du code. Sur votre ordinateur, la clé va dans le fichier .env.local, que le projet n'envoie pas sur GitHub. Une clé secrète envoyée sur GitHub fait partie des douze pièges racontés dans la formation.
• En ligne, dans les réglages de Vercel. Vercel, qui met l'application en ligne, garde les clés dans les réglages du projet, sous le nom de variables d'environnement.
• Avec le moins de droits possible. Quand le service le permet, créez une clé qui lit seulement.
• Une clé d'essai pour les essais. Stripe fournit des clés de test, pour essayer un paiement sans vrai argent.

Dans l'outil, une page Réglages › Connexions liste chaque service relié avec son état (connecté, clé manquante, erreur), la date du dernier appel réussi et un bouton Tester la connexion. La clé n'y apparaît jamais en entier.

La connexion et les rôles sont décrits dans Sécuriser une application créée avec l'IA.

Qu'est-ce que ça change dans votre semaine ?

Le changement se voit sur les petites tâches répétées :

• Le taux de change est déjà dans le calcul de prix, avec sa date.
• Au téléphone, l'historique d'achat du client s'affiche dans sa fiche.
• Les nouvelles fiches arrivent avec une adresse vérifiée et, pour les entreprises, un SIREN.
• Chaque demande envoyée par le site devient une fiche, quand vous savez relier un formulaire de contact à un CRM.
• Qonto et Pennylane se lisent sur un même écran, pour suivre sa trésorerie en temps réel.
• Un rapport hebdomadaire automatique rassemble chaque lundi les chiffres de plusieurs services.

L'intelligence artificielle se branche elle aussi par une API : votre outil peut demander à Claude de résumer un e-mail ou de proposer une relance, comme pour intégrer l'IA dans son application.

Quelles sont les limites d'une API ?

• Tous les logiciels n'en ont pas. Sans API, il reste souvent l'export d'un fichier, à importer dans votre outil.
• Les réponses arrivent par pages. Une API renvoie rarement tout d'un coup. Un branchement qui lit seulement la première page oublie des lignes les jours chargés. Demandez à Claude s'il lit bien toutes les pages.
• Chaque champ a un sens précis. Un prix hors taxes pris pour un prix public fait partie des pièges racontés dans la formation. Faites confirmer par Claude, dans la documentation, le sens de chaque champ affiché.
• Une API évolue. Un service peut changer une adresse ou un champ. Un journal des appels en erreur vous le signale tôt. Un webhook muet pendant trois jours compte aussi parmi ces pièges.
• Certaines API se paient à l'usage, comme l'API de Claude. La page de tarifs de chaque service fait foi.
• Les logiciels réglementés restent en place. La comptabilité légale, la banque et la paie restent dans les logiciels prévus pour, et l'outil maison s'y relie quand ils ont une API.

Questions fréquentes

Faut-il savoir programmer pour utiliser une API ?

Utiliser une API ne demande pas de savoir programmer quand on travaille avec Claude Code. Vous décrivez l'écran voulu en français, et Claude lit la documentation de l'API puis écrit le code. Votre rôle consiste à choisir l'API, à ranger la clé et à vérifier les chiffres à l'écran.

Une API est-elle gratuite ?

Une API peut être gratuite ou payante selon le service. L'API Adresse et l'API Recherche d'entreprises, par exemple, sont ouvertes sans inscription. D'autres API sont réservées à certaines offres ou facturées à l'usage, comme l'indique la page de tarifs du service.

Quelle différence entre une API et un webhook ?

Avec une API, votre outil pose une question au service et reçoit une réponse. Avec un webhook, le service prévient votre outil de lui-même quand un événement se produit, par exemple une nouvelle commande Shopify. Une API et un webhook se complètent souvent dans un même branchement.

Que faire si une clé d'API a été divulguée ?

Une clé d'API divulguée doit être révoquée tout de suite dans les réglages du service qui l'a fournie, puis remplacée par une nouvelle clé. Rangez ensuite la nouvelle clé dans le fichier .env.local et dans les réglages de Vercel. Effacer la clé du code ne suffit pas, parce que l'historique de GitHub la garde.

Par où commencer

Choisissez une information que vous recopiez chaque semaine d'un logiciel vers un autre. Cherchez le nom de ce logiciel suivi du mot « API », puis demandez à Claude Code de résumer sa documentation.

Si Claude n'est pas encore installé sur votre ordinateur, les deux leçons gratuites montrent comment faire et quel abonnement choisir. Un premier branchement utile consiste ensuite à être prévenu à chaque commande, comme l'explique Un webhook, c'est quoi ?.