API : définition
Aussi appelé : interface de programmation, Application Programming Interface, API REST, API web.
Mis à jour le
Rédigé par Karim Brahim

Définition
Une API (interface de programmation) est un ensemble de règles qui permet à deux logiciels d'échanger des données ou de déclencher des actions.
API signifie « Application Programming Interface ». On peut la comparer au guichet d'une administration : vous ne voyez pas l'organisation interne, mais vous savez quel formulaire déposer et quelle réponse obtenir. Une API décrit de la même façon les demandes qu'un logiciel accepte et ce qu'il renvoie.
En détail
Sur le web, la plupart des API fonctionnent sur le même principe :
- une requête : un logiciel envoie une demande à une adresse précise, par exemple « donne-moi la liste des factures impayées » ou « crée ce contact » ;
- une authentification : la demande contient une clé ou un jeton d'accès qui prouve qu'elle est autorisée ;
- une réponse : le logiciel interrogé renvoie les données demandées ou confirme l'action, dans un format structuré lisible par une machine (très souvent JSON).
Les API sont partout : paiement en ligne, cartes, envoi de SMS, messageries, modèles d'intelligence artificielle, logiciels de comptabilité et de facturation. Elles sont la base des intégrations logicielles et de l'automatisation des processus. Pour comprendre les échanges HTTP qui les portent, la documentation de MDN Web Docs est une bonne référence.
Elles complètent le webhook, qui fonctionne dans l'autre sens : c'est le logiciel source qui prévient les autres quand un événement survient.
Exemple (cas type)
Prenons l'exemple d'une boutique en ligne qui gère son stock dans un logiciel de gestion, vend sur son site et expédie via un transporteur. Chaque jour, une salariée recopierait les commandes et les numéros de suivi d'un outil à l'autre.
En reliant les API des trois outils, chaque commande payée pourrait descendre automatiquement dans la gestion commerciale. Le stock serait mis à jour sur le site, l'étiquette de transport générée et le numéro de suivi envoyé au client. La salariée se consacrerait au service client, avec beaucoup moins d'erreurs de recopie.
Points d'attention
Une API ouvre un accès direct à vos données : sa mise en place demande des règles de sécurité, un suivi des coûts et une maintenance dans la durée.
- Sécurité des clés : une clé d'API donne accès à vos données. Elle ne doit jamais apparaître dans le code visible par les visiteurs ni circuler par e-mail.
- Droits minimaux : n'accordez à chaque connexion que les autorisations nécessaires.
- Limites et coûts : de nombreuses API limitent le nombre d'appels ou les facturent au volume.
- Évolutions : les éditeurs font évoluer leurs API ; une intégration doit être surveillée et maintenue.
- Données personnelles : chaque échange de données clients doit être prévu dans votre registre et vos contrats (RGPD).
Pour aller plus loin
Pour supprimer les doubles saisies entre vos outils, lisez notre guide pour connecter les logiciels de l'entreprise. Si aucun connecteur existant ne convient, notre équipe de développement logiciel sur mesure construit la liaison, et notre offre d'automatisation des processus orchestre les échanges.