API : définition et guide pratique pour PM
Une API (application programming interface, ou interface de programmation) permet à un logiciel de demander des données ou des actions à un autre selon des règles établies. Côté web, la plupart des API passent par HTTP : un client envoie une requête à un endpoint (une URL) avec une méthode comme GET ou POST, et reçoit en retour un statut chiffré accompagné, le plus souvent, de données JSON. La documentation, souvent une spécification OpenAPI, est le contrat sur lequel les deux parties s'appuient.
Définition rédigée par Alex Dionisio, Senior Product Manager. Mis à jour le 13 novembre 2026.
Pourquoi c’est important pour un PM
Les intégrations avec un prestataire de paiement, un CRM, un modèle d'IA ou un partenaire passent toutes par des API, et leurs limites façonnent le produit : quotas, pagination, authentification, erreurs renvoyées, retrait des anciennes versions. Un PM capable de lire une documentation d'API et d'envoyer une requête de test cadre une intégration avec justesse et rédige une spec qui prévoit aussi les échecs.
Exemple
En cadrant une intégration CRM, une PM lit la documentation de l'API et remarque que les contacts ne se récupèrent que par lots de 100, avec une limite de 10 requêtes par seconde. Synchroniser 200 000 contacts prendra du temps : la spec prévoit un import initial en tâche de fond, puis des mises à jour incrémentales.
Comment fonctionne un appel d'API ?
Dans une API REST, le style le plus répandu sur le web, l'application cliente adresse une requête à une adresse appelée endpoint, avec une méthode qui indique l'action voulue : GET sert à la lecture, POST à la création, PUT ou PATCH à la mise à jour, DELETE à la suppression. La requête porte des en-têtes, dont la clé ou le jeton d'authentification, et souvent un corps au format JSON. Le serveur répond par un code de statut et, le plus souvent, par un corps JSON lui aussi.
La documentation décrit, pour chaque endpoint, les paramètres acceptés, la forme de la réponse et les erreurs possibles. Beaucoup d'API publient cette description dans un format standard, OpenAPI, qui permet de générer une documentation interactive et d'essayer les appels sans écrire de code.
REST, GraphQL, webhook : quelles différences ?
REST organise l'API autour de ressources (clients, commandes, factures), chacune avec son adresse. GraphQL expose un point d'entrée unique où le client décrit exactement les champs voulus, ce qui évite de multiplier les appels pour un écran riche, au prix d'une mise en place plus exigeante côté serveur. gRPC, fréquent entre services internes, privilégie la performance avec un format binaire.
Un webhook inverse le sens de l'échange : au lieu d'interroger une API à intervalles réguliers pour savoir si quelque chose a changé, votre système reçoit un appel au moment où l'événement se produit, par exemple un paiement confirmé. La plupart des intégrations combinent les deux : le webhook prévient, l'API fournit le détail.
Comment évaluer l'API d'un partenaire avant de s'engager ?
Parcourez la documentation avec quelques questions concrètes. L'API couvre-t-elle tout ce que le parcours utilisateur exige, ou certaines données ne sont-elles visibles que dans l'interface du partenaire ? Quelles limites de débit et de volume s'appliquent ? Des webhooks évitent-ils d'interroger en boucle ? Existe-t-il un environnement de test ? Comment les changements sont-ils annoncés, et combien de temps une ancienne version reste-t-elle disponible ?
Un essai rapide avec un outil comme Postman, ou une simple commande curl, en dit souvent plus que la page commerciale : clarté des messages d'erreur, cohérence des noms de champs, temps de réponse. Consultez aussi la page d'état du service et l'historique des incidents : un partenaire peu fiable devient votre propre problème de fiabilité.
Que prévoir quand votre produit expose sa propre API ?
Une API publique est un produit à part entière, avec ses propres utilisateurs : les développeurs de vos clients et partenaires. Qui sont-ils, et quelles tâches veulent-ils automatiser ? Comment les authentifier et borner leurs droits ? Comment faire évoluer l'API sans casser leurs intégrations ? Quelle documentation, quel support, quels indicateurs d'adoption ? Chaque endpoint publié devient un engagement difficile à retirer.
Points clés
- Le frontend appelle le backend via une API ; le backend appelle à son tour des API tierces.
- Les codes de statut indiquent l'issue : 2xx pour un succès, 4xx pour un problème dans la requête, 5xx pour une panne côté serveur.
- L'authentification repose sur des clés d'API ou des jetons, comme les jetons d'accès OAuth 2.0, avec des scopes qui limitent l'accès.
- Les politiques de versionnement et de dépréciation disent combien de temps une intégration continuera de fonctionner.
Erreurs fréquentes
- Ne spécifier que le cas nominal et laisser la gestion des erreurs au hasard.
- Ignorer les quotas jusqu'à ce qu'une synchronisation échoue en production.
- Placer des clés d'API dans le code frontend ou dans des documents partagés.
Pour aller plus loin dans Module
Les formations et les leçons qui traitent cette notion :
Guides sur ce thème
- Claude Code pour Product Manager
Ce qu’un PM peut faire avec Claude Code, la méthode et les garde-fous, avec un CLAUDE.md de départ.
- MCP ou API : quelle différence
Quand exposer une API, un serveur MCP ou les deux, et ce que cela change pour votre produit.