API (Application Programming Interface)

Définition

Une API (Application Programming Interface, interface de programmation) est un ensemble de règles qui permet à deux logiciels de communiquer et d'échanger des données sans que l'un ait besoin de connaître le fonctionnement interne de l'autre. Elle définit ce qu'on peut demander (une disponibilité, un prix, une action) et sous quelle forme la réponse arrive. C'est la brique technique qui permet à un système d'en interroger — ou d'en actionner — un autre.

Pourquoi ça compte

L'API est le mécanisme concret derrière plusieurs concepts déjà centraux de ce glossaire : le MCP est un standard qui uniformise la façon dont un agent IA interroge des API variées ; le commerce agentique suppose que le catalogue, les prix et les disponibilités soient exposés via une interface que l'agent peut appeler ; et l'actionnabilité dépend souvent — mais pas systématiquement — d'une API pour vérifier une donnée en temps réel plutôt que de se fier à un texte statique. Sans API, un agent ne peut qu'observer ce qui est écrit sur une page ; avec elle, il peut vérifier et agir. C'est la différence entre décrire un stock et pouvoir le consulter en direct.

Exemple concret

Un site e-commerce affiche « en stock » sur une fiche produit, en texte fixe. Un agent IA chargé de vérifier une disponibilité avant achat ne peut se fier à ce texte, potentiellement obsolète. Le même site, s'il expose une API de disponibilité, permet à l'agent d'interroger le stock réel au moment précis de la demande et d'obtenir une réponse à jour — la différence entre une affirmation figée et une donnée vérifiable en temps réel.

Comment l'aborder

• Distinguer API et données structurées : une API répond à une requête en temps réel ; les données structurées décrivent une page de façon statique. Les deux peuvent se compléter.
• Documenter clairement ce que l'API expose et comment l'interroger, pour qu'un système tiers (ou un agent) puisse s'y fier.
• Garder les données à jour : une API qui renvoie une information périmée est aussi trompeuse qu'un texte statique obsolète.
• Ne pas la considérer comme obligatoire : des données structurées riches et à jour suffisent dans de nombreux cas, sans nécessiter une API dédiée.

Erreurs fréquentes

• Croire qu'une API est indispensable pour être « actionnable » — souvent, des données structurées à jour suffisent.
• Exposer une API dont les données ne sont pas synchronisées avec la réalité (stock, prix), pire qu'une absence d'API.
• Confondre API et site web : une API sert des données à des systèmes, pas des pages à des humains.
• Négliger la documentation, qui rend l'API inutilisable pour qui voudrait s'y connecter.

Termes liés

• MCP (Model Context Protocol)
• Commerce agentique
• Actionnabilité (couche GEO « agent »)
• Web transactionnel
• Données structurées (Schema.org / JSON-LD)
• Agent IA

FAQ

Faut-il une API pour être actionnable par les agents IA ? Pas nécessairement. Des données structurées riches et à jour suffisent dans beaucoup de cas ; une API devient décisive quand une vérification en temps réel (stock, prix, créneau) conditionne l'action.

Quelle différence entre une API et des données structurées ? Les données structurées décrivent une page de façon statique, lue au moment de l'exploration. Une API répond en temps réel à une requête précise — elle permet de vérifier une information au moment exact où elle est nécessaire, pas seulement de la décrire.

Le MCP remplace-t-il les API ? Non, il les uniformise. Le MCP est un protocole qui standardise la façon dont un agent interroge des API variées, plutôt qu'une intégration sur mesure pour chacune. L'API reste la brique technique sous-jacente.