Une liste rapide et consultable des codes d'état HTTP
Chaque fois qu'un navigateur, une application mobile ou un robot de moteur de recherche effectue une requête vers un serveur web, ce dernier répond par un nombre à trois chiffres. Ces codes d'état HTTP indiquent au client exactement ce qui s'est passé : si la requête a réussi, a échoué, nécessite une authentification ou doit être redirigée ailleurs.
Cet outil fournit un dictionnaire complet avec recherche des codes de réponse HTTP standards, basé sur les spécifications RFC officielles. Comme la liste entière est chargée et filtrée localement dans votre navigateur, la recherche est instantanée. Vous n'avez pas besoin d'attendre le rechargement de la page pour vérifier la différence entre un 301 et un 302, ou pour comprendre ce que signifie une erreur 422.
Les cinq classes de codes de réponse HTTP
Les codes HTTP sont regroupés en cinq classes distinctes, définies par leur premier chiffre. Comprendre ces catégories est le moyen le plus rapide de diagnostiquer les problèmes de trafic web :
1xx (Information)
Ces codes indiquent que le serveur a reçu la requête et poursuit le traitement. Ce sont des réponses temporaires, et le client doit attendre une réponse finale. Par exemple, 100 Continue indique au client de poursuivre et d'envoyer le corps de la requête.
2xx (Succès)
Un code 2xx signifie que la requête du client a été reçue, comprise et acceptée avec succès. Le plus courant est 200 OK, qui est la réponse standard pour une requête HTTP réussie. Lors de la création d'un nouvel enregistrement via une API, vous pouvez voir un 201 Created.
3xx (Redirection)
Ces codes indiquent au client qu'une action supplémentaire est nécessaire pour terminer la requête. Cela signifie généralement que la ressource demandée a été déplacée. Un 301 Moved Permanently indique aux moteurs de recherche de mettre à jour leurs liens, tandis qu'un 302 Found signale un déplacement temporaire.
4xx (Erreur client)
Les codes d'erreur HTTP de la série 4xx signifient que le problème vient du client. La requête peut contenir une erreur de syntaxe, manquer d'authentification ou demander une ressource qui n'existe pas. Ces erreurs sont fréquentes lorsque les utilisateurs font une faute de frappe dans l'URL ou lorsque les intégrations d'API envoient des données mal formatées.
5xx (Erreur serveur)
Un code 5xx signifie que le serveur n'a pas pu traiter une requête valide. Le client a tout fait correctement, mais le serveur a rencontré un problème interne, a planté ou est actuellement surchargé.
Les codes d'erreur HTTP courants à connaître
Bien qu'il existe des dizaines de codes, quelques-uns représentent la grande majorité des erreurs que vous rencontrerez en tant que développeur ou webmaster :
Le code d'état 404 (Not Found)
Probablement l'erreur la plus connue d'Internet, le code 404 signifie que le serveur n'a pas pu trouver la ressource demandée. Pour les propriétaires de sites, surveiller les erreurs 404 est crucial pour le SEO, car les liens cassés frustrent les utilisateurs et gaspillent le budget de crawl.
400 Bad Request
Le serveur ne peut pas traiter la requête en raison d'une erreur côté client, comme une syntaxe mal formée ou un routage invalide. Les API renvoient fréquemment ce code lorsqu'un paramètre requis est manquant.
401 Unauthorized & 403 Forbidden
Ces deux codes concernent l'accès. Un 401 Unauthorized signifie que le client doit s'authentifier pour obtenir la réponse demandée (ex. : clé API manquante). Un 403 Forbidden signifie que l'identité du client est connue, mais qu'il ne dispose pas des permissions nécessaires pour accéder à la ressource.
500 Internal Server Error
Il s'agit d'une erreur générique pour les plantages côté serveur. Cela signifie que le serveur a rencontré une condition inattendue l'empêchant de traiter la requête. Lorsque vous rencontrez une erreur 500, vous devez généralement consulter les logs de l'application du serveur pour trouver l'origine du problème.
502 Bad Gateway & 503 Service Unavailable
Un 502 Bad Gateway se produit lorsqu'un serveur agissant comme proxy (comme Nginx ou un load balancer) reçoit une réponse invalide du serveur en amont. Un 503 Service Unavailable signifie que le serveur est actuellement incapable de traiter la requête, généralement parce qu'il est surchargé ou en maintenance.
Bonnes pratiques pour le développement d'API
Lors de la création d'une API REST, renvoyer les bons codes d'état HTTP est essentiel pour offrir une bonne expérience développeur. Renvoyer un 200 OK lorsqu'une erreur s'est réellement produite (ce qu'on appelle souvent "masquer" les erreurs) oblige les clients à analyser manuellement le corps de la réponse pour savoir si leur requête a vraiment abouti.
Utilisez cette référence pour choisir le code le plus approprié sémantiquement. Par exemple, utilisez 429 Too Many Requests lorsqu'un utilisateur atteint une limite de requêtes, ou 422 Unprocessable Content lorsque le payload JSON est valide mais ne respecte pas la logique métier.
Si vous analysez des problèmes de routage serveur, notre outil de Recherche DNS pourrait vous être utile pour vérifier les enregistrements de domaine, tout comme l'Analyseur de User-Agent pour identifier les clients qui interrogent votre serveur. Si vous cherchez à contrôler l'exploration de votre site par les moteurs de recherche afin d'éviter les erreurs 404, essayez le Générateur de robots.txt.