Qu'est-ce qu'une API ? Définition et usages

Une API est la porte d'entrée qu'un logiciel ouvre aux autres. Définition simple, exemple d'appel réel, types d'API et usages concrets pour faire communiquer les outils de votre entreprise.

Une API (interface de programmation d’application) est une porte d’entrée qu’un logiciel ouvre à d’autres logiciels, avec des règles précises pour demander des données ou déclencher des actions. C’est grâce aux API que votre site encaisse un paiement, que votre CRM envoie les factures à votre logiciel comptable ou qu’un formulaire complète une adresse tout seul. Pour une entreprise, une API sert surtout à faire communiquer ses outils sans ressaisie manuelle.

On explique ici simplement comment fonctionne une API, avec un vrai exemple d’appel, les grands types d’API, ce qu’elles apportent concrètement à une entreprise et comment démarrer, que vous utilisiez une API existante ou que vous en fassiez créer une.

Qu’est-ce qu’une API, simplement ?
Comment fonctionne une API ?
À quoi ressemble un appel d’API ?
Quels sont les types d’API ?
Comment une API peut-elle aider votre entreprise ?
Comment commencer à utiliser une API ?
Comment mettre en place votre propre API ?
Quelles précautions prendre ?
Questions fréquentes
Sources

Qu’est-ce qu’une API, simplement ?

API est l’acronyme anglais d’Application Programming Interface. C’est un ensemble de règles qui fixent comment deux logiciels se parlent : quelles questions on peut poser, sous quelle forme, et à quoi ressemblera la réponse.

Une comparaison aide : au restaurant, vous ne rentrez pas en cuisine. Vous choisissez dans le menu et le serveur transmet la commande, puis vous apporte le plat. L’API joue le rôle du serveur, le menu est sa documentation, la cuisine est le système de l’éditeur. Vous obtenez le résultat sans connaître la recette ni accéder au reste de la cuisine.

C’est aussi une question de contrôle : l’éditeur décide exactement ce qu’il expose, à qui, et dans quelles limites. Ses données restent chez lui.

Comment fonctionne une API ?

Pour une API web, le principe est toujours le même :

Votre application envoie une requête à une adresse précise (le point d’accès, ou endpoint), avec une méthode (lire, créer, modifier, supprimer) et éventuellement des paramètres.
Elle s’identifie, le plus souvent avec une clé d’API ou un jeton fourni par l’éditeur.
Le serveur vérifie les droits, exécute la demande et renvoie une réponse : des données, généralement au format JSON, et un code qui indique si tout s’est bien passé (200) ou non (404 si la ressource n’existe pas, 401 si l’identification manque…).

Le format JSON est expliqué dans notre comparatif JSON vs XML.

À quoi ressemble un appel d’API ?

Prenons une API publique et gratuite de l’État : le service de géocodage de la Géoplateforme, qui a remplacé l’API Adresse de la Base Adresse Nationale. On lui envoie une adresse, elle renvoie l’adresse normalisée et ses coordonnées GPS. C’est ce qui permet à un formulaire de proposer l’adresse complète dès les premiers caractères.

GET https://data.geopf.fr/geocodage/search?q=1+place+de+la+comedie+montpellier&limit=1

Réponse (extrait) :

{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [3.878782, 43.60828] },
  "properties": {
    "label": "1 Place de la Comédie 34000 Montpellier",
    "postcode": "34000",
    "citycode": "34172",
    "city": "Montpellier",
    "context": "34, Hérault, Occitanie"
  }
}

Votre site n’a pas besoin de stocker toutes les adresses de France : il pose la question, l’API répond en une fraction de seconde. Le catalogue des API publiques françaises est accessible sur data.gouv.fr.

Quels sont les types d’API ?

Selon qui peut y accéder

API publiques (ouvertes) : accessibles à tous, parfois avec une simple inscription. Exemple : les API publiées par l’administration sur data.gouv.fr.
API partenaires : réservées à des partenaires sous contrat, par exemple un fournisseur qui donne accès à son catalogue et à ses stocks à ses revendeurs.
API privées (internes) : utilisées seulement à l’intérieur de l’entreprise, par exemple entre le site e-commerce et l’outil de gestion des stocks.

Beaucoup de services payants (paiement, envoi de SMS, signature électronique) sont des API publiques au sens où tout le monde peut s’inscrire, mais facturées à l’usage. La documentation de l’API de Stripe, par exemple, est librement consultable.

Selon leur architecture

Type	Principe	Où on le rencontre
REST	Des ressources identifiées par des URL, manipulées avec les méthodes HTTP, souvent en JSON	La grande majorité des API web
SOAP	Des messages XML très normalisés (recommandation du W3C)	Banque, assurance, administrations, logiciels anciens
GraphQL	Le client décrit précisément les données qu’il veut, en une requête	Applications avec des besoins de données variés
gRPC	Appels rapides entre services, avec des messages binaires (Protocol Buffers)	Communication entre microservices
Webhook	C’est l’API qui vous prévient quand un événement survient (paiement reçu, commande créée)	Paiement, e-commerce, automatisations

Comment une API peut-elle aider votre entreprise ?

Supprimer la ressaisie : une commande passée sur le site crée automatiquement le client dans le CRM et la facture dans le logiciel comptable. Moins de temps perdu, moins d’erreurs de frappe.
Ajouter des fonctions sans les développer : paiement en ligne, cartes, calcul des frais de port, vérification d’adresse ou de numéro SIRET, envoi d’e-mails transactionnels.
Avoir des données à jour partout : stocks, prix et disponibilités synchronisés entre la boutique, les places de marché et le point de vente.
Ouvrir votre activité à des partenaires : revendeurs, comparateurs ou plateformes peuvent se brancher sur votre catalogue ou votre système de réservation.
Garder la main sur vos outils : changer de logiciel est plus simple quand chaque outil communique par une API documentée plutôt que par des exports manuels.

Ce type de connexion entre logiciels est souvent la première étape d’un outil métier ou d’une automatisation plus large. Beaucoup de logiciels en ligne (voir qu’est-ce que le SaaS) proposent une API : vérifiez-le avant de les choisir.

Comment commencer à utiliser une API ?

Définir le besoin : quelles données doivent circuler, entre quels outils, dans quel sens et à quelle fréquence.
Vérifier ce qui existe : vos logiciels ont-ils une API ? Est-elle incluse dans votre abonnement ? Un connecteur tout prêt existe-t-il déjà ?
Lire la documentation : points d’accès, authentification, limites d’appels, tarifs, conditions d’utilisation.
Créer un compte développeur et obtenir les identifiants (clé d’API ou accès OAuth), en commençant sur un environnement de test si l’éditeur en propose un.
Tester, puis brancher : premiers appels, gestion des erreurs, mise en production et surveillance.

Comment mettre en place votre propre API ?

Créer une API se justifie quand vous voulez exposer vos données ou services à une application mobile, à des partenaires ou à vos propres outils. Les grandes étapes :

Concevoir le contrat : quelles ressources, quelles actions, quels droits. On le décrit aujourd’hui au format OpenAPI, qui sert aussi de documentation.
Choisir la technologie : PHP, Node.js, Python… le bon choix est celui que vous pourrez maintenir.
Développer et sécuriser : authentification, contrôle des droits sur chaque donnée, limitation du nombre d’appels, HTTPS.
Héberger et superviser : serveur ou cloud, journaux, alertes, sauvegardes.
Documenter et versionner : pour pouvoir faire évoluer l’API sans casser ce qui est déjà branché. Une passerelle d’API (API gateway) peut centraliser les clés, les quotas et les statistiques.

Le détail technique de chaque étape est dans notre article sur les bonnes pratiques de développement d’API. Si vous préférez déléguer, notre équipe réalise des intégrations et automatisations : une intégration API simple démarre à 1 500 €, une automatisation entre plusieurs outils à 3 000 €, et un audit de vos flux existants à 800 € (le détail est sur notre page tarifs).

Quelles précautions prendre ?

La dépendance : si l’éditeur change son API, augmente ses prix ou ferme le service, votre intégration doit évoluer. L’API Adresse, remplacée par le service de la Géoplateforme, en est un bon exemple : les sites qui l’utilisaient ont dû changer d’adresse d’appel.
Les limites d’appels : la plupart des API plafonnent le nombre de requêtes. Au-delà, elles répondent par une erreur 429.
Les coûts à l’usage : une API facturée à la requête peut coûter cher si elle est appelée à chaque affichage de page.
Les données personnelles : envoyer des données clients à un service tiers est un traitement à encadrer (contrat, registre, information des personnes au titre du RGPD).
Les clés d’API : ce sont des mots de passe. Elles ne doivent jamais apparaître dans le code visible par les visiteurs.

Questions fréquentes

Une API est-elle un logiciel ?

Non, c’est l’interface d’un logiciel : la partie qui accepte les demandes d’autres programmes. Il n’y a en général pas d’écran, seulement des échanges de données.

Quelle différence entre une API et un webhook ?

Avec une API, c’est vous qui posez la question. Avec un webhook, c’est le service qui vous envoie un message quand un événement se produit, sans que vous ayez à interroger en boucle.

Les API sont-elles gratuites ?

Certaines oui, comme de nombreuses API publiques de l’administration. D’autres sont facturées à l’usage ou réservées aux abonnements supérieurs d’un logiciel. Lisez toujours les conditions.

Faut-il savoir coder pour utiliser une API ?

Pour une intégration sur mesure, oui. Pour des cas simples, des outils d’automatisation sans code permettent de relier des services courants, avec leurs limites en volume et en fiabilité.

Une API est-elle sécurisée ?

Elle l’est si elle est conçue pour : HTTPS, authentification, contrôle des droits sur chaque donnée et limitation des appels. Une API mal protégée est au contraire une porte d’entrée directe vers vos données.

Qu’est-ce qu’une API et comment peut-elle aider votre entreprise ?

Qu’est-ce qu’une API, simplement ?

Comment fonctionne une API ?

À quoi ressemble un appel d’API ?