Aller au contenu
Logiciel & données

API : définition

Aussi appelé : interface de programmation, Application Programming Interface, API REST, API web.

Mis à jour le

Rédigé par

Schéma d'une API : une application envoie une requête au guichet de l'API, qui interroge le serveur et renvoie une réponse avec les données.
Fonctionnement d'une API : requête et réponse entre deux logiciels

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.

API : vos questions.

À quoi sert une API pour une petite entreprise ?

À faire communiquer vos outils sans ressaisie : un devis signé crée une facture, une commande en ligne met à jour le stock, un formulaire de contact alimente le CRM, un chatbot consulte vos disponibilités.

Qu'est-ce qu'une clé d'API ?

C'est un identifiant secret, proche d'un mot de passe, qui autorise un logiciel à utiliser une API. Elle se conserve côté serveur, jamais dans une page visible des visiteurs, et se révoque dès qu'elle a pu fuiter.

Tous les logiciels ont-ils une API ?

Non. La plupart des logiciels en ligne récents en proposent une, parfois réservée à certaines formules d'abonnement. Avant de choisir un outil, vérifiez l'existence et la documentation de son API.

Besoin d'aide sur ce sujet ?

Parlez-nous de votre projet : réponse rapide et devis détaillé.