Codes de statut, erreurs et décisions produit
Ce que voit l'utilisateur quand une API échoue est une décision produit, pas un détail technique. Cette leçon vous apprend à lire les codes de statut et les messages d'erreur, à séparer ce qui doit être corrigé de ce qui peut être retenté, puis à prévoir pour chaque cas le bon comportement du produit.
Mis à jour le 29 septembre 2026.
En bref
Un code de statut HTTP indique en trois chiffres le résultat d'un appel d'API : 2xx pour un succès, 4xx pour une requête à corriger, 5xx pour un problème côté serveur. Pour un PM, chaque famille d'erreur appelle une décision produit : message à l'utilisateur, nouvelle tentative automatique ou alerte à l'équipe.
Objectif de la leçon
À la fin de cette leçon, vous serez capable d'interpréter les codes de statut et les réponses d'erreur d'une API, de distinguer les erreurs à corriger de celles à réessayer, et d'associer à chacune un comportement produit (message, reprise, alerte).
Les questions auxquelles cette leçon répond
Que signifient les codes de statut HTTP pour un Product Manager ?
Ils disent si l'appel a réussi, si la requête était fautive ou si le serveur a échoué. Chaque famille appelle une réaction différente du produit, donc une décision à prendre dans la spec.
Quelles erreurs d'API faut-il réessayer et lesquelles corriger ?
On réessaie les erreurs passagères : surcharge, délai dépassé, panne côté serveur. On corrige les erreurs de requête, comme une donnée invalide ou un accès refusé, car les rejouer ne changera rien.
Quel message afficher à l'utilisateur quand une API tierce échoue ?
Un message clair qui dit ce qui s'est passé et ce que l'utilisateur peut faire, sans jargon technique. Quand le produit peut réessayer seul, mieux vaut le faire avant d'inquiéter l'utilisateur.
Thèmes abordés
- codes de statut HTTP
- gestion des erreurs API
- expérience utilisateur
- erreurs 4xx et 5xx
Dans le glossaire
Guide sur ce thème
- MCP ou API : quelle différence
Quand exposer une API, un serveur MCP ou les deux, et ce que cela change pour votre produit.
Dans quel module
Lire une API
Comment lire la documentation d'une API et comprendre ce qu'elle répond, y compris quand ça échoue ?
Leçons du module
- Lire la documentation d'une API REST
- Codes de statut, erreurs et décisions produit (cette leçon)
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Concevoir et tester une intégration API en tant que PM
Formations liées
- Tech pour PMTout publicAucun pré-requis : accessible à toutes et tous.
Expliquer comment fonctionne un produit web, du navigateur au serveur
2 h 30 min
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Construire le business case d'une fonctionnalité IA
2 h 46 min
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Obtenir des sorties IA fiables et exploitables par le produit (JSON, schémas, appels de fonction)
2 h 30 min