API
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.
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.
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 :