API : c'est quoi ? Définition simple, exemples et usages concrets en entreprise
G. CHRIST
Publié le 26 octobre 2026

Un client paie par Mobile Money sur votre site. Trois secondes plus tard, la commande passe en « payée », un reçu part par e-mail et votre équipe reçoit une alerte sur WhatsApp. Personne n'a rien recopié. Derrière ce petit miracle quotidien, il n'y a pas de magie : il y a des API.
Le mot revient partout : dans les devis d'agences, dans les offres de paiement en ligne, dans les tutoriels d'automatisation. Et il est presque toujours expliqué par des développeurs, pour des développeurs. Chez Guelichweb, nous passons une bonne partie de notre temps à connecter des outils entre eux pour des PME, des ONG et des institutions. Voici donc notre version : ce qu'est une API, comment elle fonctionne, à quoi elle sert concrètement dans une organisation en Afrique francophone, et les questions à poser avant d'en dépendre.
API : la définition simple
API signifie Application Programming Interface, en français « interface de programmation d'application ». La CNIL la définit comme une interface logicielle qui permet de « connecter » un logiciel ou un service à un autre afin d'échanger des données et des fonctionnalités.
Dit autrement : une API est une porte d'entrée officielle qu'un logiciel ouvre aux autres logiciels. Au lieu qu'un humain se connecte, clique et copie des informations, un programme envoie une demande normalisée et reçoit une réponse normalisée. Les deux systèmes n'ont pas besoin de connaître le fonctionnement interne de l'autre. Ils respectent simplement le même contrat.
L'image la plus utilisée, reprise par le site public Simplifions de data.gouv.fr, est celle du serveur au restaurant. Vous ne rentrez pas dans la cuisine. Vous passez commande au serveur, qui la transmet, puis revient avec le plat. L'API, c'est ce serveur entre deux ordinateurs. Le menu, c'est la documentation de l'API : la liste de ce que vous avez le droit de demander, et sous quelle forme.
Une API, c'est un guichet. On ne vous laisse pas entrer dans les bureaux, mais on vous répond vite et toujours de la même façon, si vous remplissez bien le formulaire.
Comment fonctionne une API, sans jargon
La grande majorité des API que rencontre une entreprise sont des API web, souvent dites « REST ». Elles passent par Internet, avec le même protocole HTTP que votre navigateur. Un échange suit toujours le même schéma.
- Le client envoie une requête. Le « client » ici n'est pas une personne : c'est le logiciel qui demande (votre site, votre application mobile, un outil d'automatisation comme n8n).
- La requête vise une adresse précise, appelée point de terminaison ou *endpoint*. C'est une URL, comme celles que vous tapez dans un navigateur. Si le mot URL reste flou, notre article URL : définition détaille chaque partie d'une adresse web.
- Elle précise une action grâce à une méthode : GET pour lire, POST pour créer, PUT ou PATCH pour modifier, DELETE pour supprimer.
- Elle prouve qui demande, le plus souvent avec une clé API ou un jeton (*token*) placé dans l'en-tête de la requête.
- Le serveur répond avec un code de statut (200 = tout va bien, 401 = non autorisé, 404 = introuvable, 500 = erreur côté serveur ; la liste complète est sur MDN) et, en général, des données au format JSON.
Le JSON fait peur au premier regard, mais c'est juste du texte organisé en paires « nom : valeur ». Un humain le lit, un programme le lit encore mieux. C'est ce qui permet à deux logiciels écrits par des équipes différentes, dans des langages différents, sur deux continents différents, de se comprendre.
À quoi ressemble une vraie réponse d'API ?
Rien ne vaut un exemple réel. Open-Meteo propose une API météo gratuite pour un usage non commercial. Nous lui avons demandé la météo actuelle à Cotonou, en tapant simplement cette adresse dans un navigateur. Voici ce qu'elle renvoie :
Source : réponse de l'API publique Open-Meteo, api.open-meteo.com, capture du 26/10/2026 à 18h30 (heure du Bénin).
Lisez la dernière ligne : « temperature_2m »: 28.2, « relative_humidity_2m »: 78, « wind_speed_10m »: 16.2. Aucune mise en page, aucune image, aucun bouton. Juste la donnée. C'est toute la différence entre une page web, faite pour les yeux, et une API, faite pour les programmes. Une application météo prend exactement ce texte et l'affiche avec de jolies icônes.
Remplacez « météo » par « solde de la caisse », « statut d'un paiement », « stock d'un produit » ou « liste des inscrits à une formation », et vous avez compris 80 % de ce que les API changent dans une organisation.
Des exemples d'API que vous utilisez déjà
Vous vous servez d'API tous les jours sans le savoir. Quelques exemples parlants :
- « Se connecter avec Google » sur un site : le site interroge l'API de Google pour vérifier votre identité, sans jamais voir votre mot de passe.
- Le paiement Mobile Money ou par carte sur une boutique : le site transmet le montant à l'API d'un agrégateur de paiement, qui lui renvoie ensuite le résultat.
- La carte Google Maps intégrée à une page « Contact » : elle s'affiche grâce à l'API de Google Maps.
- Le suivi d'un colis chez un transporteur : le site du vendeur interroge l'API du transporteur.
- Un chatbot WhatsApp qui répond à vos clients : il reçoit et envoie les messages via l'API WhatsApp Business de Meta.
- Un assistant IA intégré à un outil : l'outil envoie votre question à l'API d'un modèle de langage et affiche la réponse.
Le dernier point compte de plus en plus. Quand une entreprise dit « nous avons ajouté de l'IA à notre logiciel », elle a très souvent branché une API d'IA. C'est aussi le principe d'un agent IA : un programme qui appelle plusieurs API pour accomplir une tâche à votre place.
API et webhook : la différence qui change tout en automatisation
C'est le point que les définitions classiques expliquent mal, alors que c'est lui qui détermine si une automatisation est fluide ou bancale.
- Avec une API, c'est vous qui demandez. Votre outil interroge le service : « la commande 42 est-elle payée ? ». Si vous voulez savoir quand elle le devient, vous devez reposer la question régulièrement. On appelle ça le *polling*.
- Avec un webhook, c'est le service qui vous prévient. Vous lui donnez une adresse, et dès qu'un événement se produit (paiement approuvé, formulaire envoyé, message reçu), il envoie automatiquement les informations à cette adresse.

Schéma Guelichweb : à gauche votre outil, à droite le service externe.
Dans la pratique, les bonnes intégrations combinent les deux. Le webhook signale l'événement immédiatement ; l'API sert ensuite à récupérer le détail complet et à jour. La documentation de FedaPay, un agrégateur de paiement présent au Bénin et dans la sous-région, l'illustre bien : à chaque changement de statut d'une transaction (créée, approuvée, refusée, annulée), un événement est généré et peut être envoyé à l'URL de votre choix.
Source : documentation développeurs FedaPay, page « Webhooks et Événements », docs.fedapay.com, capture du 26/10/2026.
Cette même page donne des règles que nous appliquons sur tous nos projets, quel que soit le fournisseur : répondre très vite avec un code 2xx, puis traiter le reste ensuite ; vérifier la signature du message pour être sûr qu'il vient bien du service ; gérer les doublons, car un même événement peut arriver deux fois ; et n'écouter que les événements utiles. FedaPay indique aussi qu'en cas d'échec il réessaie jusqu'à 9 fois, puis désactive le webhook après 10 échecs. Un détail qui a son importance : si votre serveur tombe un week-end, vos paiements ne seront plus signalés tant que personne ne s'en rend compte.
Ce qu'une API change concrètement pour une PME, une ONG ou une institution
On peut parler d'architecture pendant des heures. Ce qui intéresse un dirigeant, c'est ce que ça évite. Voici les cas que nous voyons le plus souvent.
1. Supprimer la double saisie
Une demande de devis arrive par le formulaire du site. Quelqu'un la recopie dans un tableur, puis dans le CRM, puis dans un message WhatsApp au commercial. Trois saisies, trois risques d'erreur. Avec des API, le formulaire alimente directement le CRM ou un Google Sheets, et l'alerte part toute seule.
2. Encaisser et confirmer sans intervention
Pour une boutique en ligne, une école qui encaisse des frais d'inscription ou une ONG qui reçoit des dons, le webhook de paiement est la pièce centrale. Il met à jour la commande, génère le reçu, prévient le client. Notre guide créer une boutique en ligne au Bénin montre où ce maillon se place dans un projet complet.
3. Parler aux clients là où ils sont
En Afrique de l'Ouest, beaucoup de clients préfèrent WhatsApp au formulaire. L'API WhatsApp Business (Cloud API) de Meta permet d'envoyer des confirmations, des rappels de rendez-vous ou de répondre automatiquement. Nous avons détaillé son fonctionnement et sa facturation dans WhatsApp Business API : c'est quoi et combien ça coûte, et ce qu'un robot peut raisonnablement faire dans Chatbot WhatsApp : ce qu'il fait vraiment.
4. Produire des rapports qui se mettent à jour seuls
Une ONG doit rendre compte à ses bailleurs. Une institution suit des indicateurs. Plutôt que d'exporter des fichiers à la main chaque mois, les données de plusieurs outils (formulaires de terrain, comptabilité, CRM) peuvent remonter via API dans un même tableau de bord. Le rapport n'est plus un chantier mensuel, c'est une page qu'on consulte.
5. Ajouter de l'IA sans changer d'outils
Résumer des messages entrants, classer des demandes, rédiger un premier jet de réponse : tout cela passe par l'API d'un modèle d'IA, branchée sur vos outils existants. C'est souvent la façon la plus raisonnable de commencer avec l'IA, parce qu'on n'oblige personne à changer ses habitudes.
Faut-il savoir coder pour utiliser une API ?
Non, plus vraiment. C'est même la raison du succès des outils d'automatisation comme n8n, Make ou Zapier. Ils proposent des connecteurs prêts à l'emploi pour des centaines de services, et, quand un connecteur n'existe pas, un bloc générique qui appelle n'importe quelle API.
Chez n8n, ce bloc s'appelle HTTP Request. Sa documentation explique qu'il permet d'interroger n'importe quel service doté d'une API REST : on choisit la méthode, on colle l'URL, on configure l'authentification, et l'on peut même importer directement une commande « curl » copiée depuis la documentation du service.
Source : documentation officielle de n8n, page « HTTP Request », docs.n8n.io, capture du 26/10/2026.
L'équivalent côté réception est le nœud Webhook : il crée une URL que vous donnez au service externe, et chaque notification reçue déclenche votre scénario. Pour choisir entre ces outils, lisez n8n ou Make : quel outil d'automatisation choisir et notre comparatif Zapier, Make ou n8n.
Notre avis, après de nombreux projets : savoir coder n'est pas indispensable, mais savoir lire une documentation d'API l'est. Celui qui comprend ce qu'est un endpoint, une clé, un code 401 et une réponse JSON avance dix fois plus vite, même dans un outil sans code. C'est la compétence que nous conseillons d'acquérir à la personne qui gère les outils numériques en interne.
Clé API : ce qu'il faut savoir (et ne jamais faire)
La clé API, c'est le badge d'accès. Celui qui la possède parle au service en votre nom : il peut lire vos clients, créer des transactions, envoyer des messages facturés sur votre compte. Traitez-la comme le code de votre coffre.
- Ne la collez jamais dans un message WhatsApp, un e-mail ou un document partagé. Transmettez-la par un gestionnaire de mots de passe ou saisissez-la directement dans l'outil.
- Ne la placez jamais dans le code visible d'un site (JavaScript côté navigateur). Certains services fournissent une clé publique prévue pour ça ; la clé secrète, elle, reste sur le serveur.
- Séparez test et production. FedaPay, comme la plupart des services de paiement, fournit des clés de test et des clés « live ». Développez avec les premières.
- Une clé par usage, pour pouvoir en révoquer une sans tout casser.
- Révoquez-la au départ d'un prestataire ou d'un employé qui y avait accès, exactement comme on change les serrures.
- Donnez le minimum de droits. Si une intégration a seulement besoin de lire, ne lui donnez pas le droit de supprimer.
Ce n'est pas de la paranoïa. Le projet de référence OWASP API Security Top 10 recense les failles les plus fréquentes des API, et les problèmes d'autorisation et d'authentification y occupent les premières places. Les attaquants savent que les API sont souvent moins surveillées que les pages visibles d'un site. Et, bien sûr, toute API sérieuse fonctionne en HTTPS : notre article sur le certificat SSL explique pourquoi.
API gratuite ou payante : combien ça coûte ?
Il n'y a pas de prix unique, et méfiez-vous de quiconque vous en annonce un sans avoir regardé votre cas. Il faut distinguer trois choses.
- Le coût d'usage de l'API elle-même. Certaines sont gratuites (beaucoup d'API publiques et d'open data), d'autres gratuites jusqu'à un certain volume, d'autres facturées à l'appel, au message ou en pourcentage de la transaction. Le paiement en ligne se facture généralement par transaction ; l'API WhatsApp, par message selon sa catégorie. Vérifiez toujours la grille officielle du fournisseur.
- Le coût de l'outil qui fait le lien, s'il y en a un : abonnement à un outil d'automatisation, ou hébergement d'une instance n8n.
- Le coût de mise en place et de suivi : comprendre les besoins, configurer, tester les cas d'erreur, documenter, surveiller. C'est souvent le poste le plus sous-estimé, et pourtant celui qui fait la différence entre une intégration fiable et une source de pannes.
Nous avons consacré un article entier à ce sujet : combien coûte une automatisation IA au Bénin. Pour les projets Guelichweb, nous ne publions pas de tarif fixe : nous commençons par un diagnostic, puis nous établissons un devis adapté, comme expliqué sur notre page offres.
Avant de dépendre d'une API : notre liste de vérification
Brancher une API, c'est confier une partie de votre activité à un service extérieur. Avant de vous engager, posez ces questions.
- La documentation est-elle claire et à jour ? Une API mal documentée coûte cher en temps de développement, à chaque modification.
- Existe-t-il un environnement de test ? Sans bac à sable, chaque essai se fait sur de vraies données ou de vrais paiements.
- Que se passe-t-il quand le service est indisponible ? Une bonne intégration prévoit les nouvelles tentatives, les alertes et un mode dégradé.
- Quelles sont les limites d'usage ? Beaucoup d'API limitent le nombre d'appels par minute ou par jour. Vérifiez que vos pics d'activité (rentrée scolaire, campagne de dons, soldes) passent.
- Où partent les données ? Si vous transmettez des données personnelles de clients, de bénéficiaires ou de patients, vérifiez les conditions du fournisseur et vos obligations. Au Bénin, le Code du numérique encadre la protection des données personnelles.
- Le fournisseur a-t-il un historique de changements ? Une API évolue. Un journal des versions et des annonces d'obsolescence vous laisse le temps de vous adapter.
- Pouvez-vous récupérer vos données et partir ? Une API qui permet d'exporter facilement vos données est un bon signe. Le contraire est un piège.
Si un outil que vous envisagez n'a pas d'API du tout, c'est aussi une information. Il vous obligera tôt ou tard à recopier des données à la main. Pour un outil central, comme un CRM, une caisse ou une plateforme de dons, nous considérons l'absence d'API comme un motif sérieux de chercher ailleurs.
Les erreurs que nous voyons le plus souvent
- Automatiser un processus qui n'est pas clair. Une API accélère ce qui existe. Si personne ne sait qui valide un devis, l'automatisation accélérera la confusion.
- Ne rien prévoir quand ça échoue. Une intégration qui marche le jour de la démonstration et qui casse en silence un mois plus tard est pire que pas d'intégration du tout.
- Tout faire reposer sur le compte personnel d'une seule personne. Les clés et les comptes de service doivent appartenir à l'organisation.
- Ignorer les doublons. Un paiement reçu deux fois par webhook ne doit pas créer deux commandes ni deux reçus.
- Confondre « connecté » et « fiable ». Testez avec des cas réels : un paiement refusé, un client sans e-mail, un nom avec des accents, une coupure réseau.
FAQ : vos questions sur les API
Que veut dire API en informatique ?
API signifie Application Programming Interface, ou interface de programmation d'application. C'est un ensemble de règles qui permet à un logiciel de demander des données ou des actions à un autre logiciel, de façon automatique et sécurisée.
Quel est un exemple simple d'API ?
Une application météo qui affiche la température : elle ne mesure rien elle-même, elle interroge l'API d'un service météo et affiche la réponse. Le bouton « Se connecter avec Google » ou le paiement Mobile Money sur un site sont d'autres exemples courants.
Quelle différence entre une API et un site web ?
Un site web renvoie des pages mises en forme pour les humains. Une API renvoie des données brutes, souvent en JSON, pour les programmes. Beaucoup de services ont les deux : un site pour vous, une API pour vos outils.
Qu'est-ce qu'une API REST ?
C'est le style d'API web le plus répandu. Elle utilise le protocole HTTP, des adresses (endpoints) pour chaque ressource et des méthodes standard comme GET, POST, PUT et DELETE. AWS en donne une explication détaillée.
Quelle différence entre une API et un webhook ?
Avec une API, votre outil pose la question quand il en a besoin. Avec un webhook, le service envoie l'information de lui-même dès qu'un événement se produit. Les automatisations solides utilisent souvent les deux.
Une API est-elle gratuite ?
Certaines oui, d'autres non. Beaucoup proposent un niveau gratuit limité, puis une facturation à l'usage. Le paiement en ligne et l'envoi de messages WhatsApp, par exemple, sont facturés selon les grilles des fournisseurs.
Mon site actuel peut-il être connecté à d'autres outils ?
Souvent, oui. Tout dépend de la technologie du site, des outils visés et de la présence d'API de part et d'autre. C'est précisément ce que nous vérifions lors d'un diagnostic.
Envie de connecter vos outils ?
Si vos équipes passent encore du temps à recopier des informations entre un formulaire, un tableur, WhatsApp et la comptabilité, il y a probablement une API qui peut faire ce travail. Contactez Guelichweb : nous regardons vos outils et vos processus, nous vous disons ce qui peut être connecté et ce qui ne vaut pas la peine, puis nous vous proposons un devis après diagnostic. Vous pouvez aussi découvrir notre offre chatbot WhatsApp avec n8n au Bénin et l'ensemble de nos services.


