Codes de statut HTTP — 100 à 599, RFC et codes non officiels

Ce que fait Codes de statut HTTP

Codes de statut HTTP est une référence consultable des codes de réponse de 100 à 599. Elle aide lors du débogage d'appels d'API, de la rédaction de documentation, du choix d'une réponse pour un nouvel endpoint, de la lecture de logs, de l'examen du comportement d'une passerelle ou de l'explication d'une panne à un autre développeur. Chaque entrée comprend le code numérique, la phrase de raison, la catégorie, la RFC qui le définit et une courte description de ce que la réponse signifie habituellement. Des puces de filtre réduisent la liste aux codes informatifs, de succès, de redirection, d'erreur client ou d'erreur serveur.

Le trafic réel contient aussi des codes qu'aucune norme ne définit. Un 499 dans un log nginx signifie que le client a abandonné avant la réponse du serveur ; un 522 de Cloudflare signifie que l'origine n'a pas terminé la poignée de main TCP ; un 460 ou un 561 provient d'un répartiteur de charge AWS. Ces codes non officiels sont listés dans leur propre groupe avec le produit qui les émet, afin que vous puissiez vite savoir si une panne vient de votre application, d'un proxy ou d'un CDN. Un clic sur un résultat copie le code et la phrase pour des commentaires de ticket, de la documentation, des tests ou des notes d'endpoint.

Un flux de travail privé dans le navigateur

Tout le traitement s'effectue dans votre navigateur avec du JavaScript côté client. La liste est intégrée directement dans la page au lieu d'être récupérée depuis un service, ce qui la rend rapide et disponible même hors ligne ou lors du débogage de problèmes réseau, et rien de ce que vous saisissez n'est envoyé ailleurs.

Conseils pratiques

Les codes de statut font partie du contrat d'une API : choisissez-les donc délibérément. Utilisez des réponses de la famille 400 lorsque le client peut modifier sa requête, de la famille 500 lorsque le serveur n'a pas pu traiter une requête valide, et de la famille 300 lorsque le client doit chercher ailleurs. Les échecs d'authentification et d'autorisation sont souvent confondus : 401 signifie généralement que l'authentification est requise ou invalide, tandis que 403 signifie que l'appelant authentifié n'est pas autorisé. Préférez 422 pour les erreurs de validation d'un corps bien formé, 409 pour les conflits d'état et 429 avec un en-tête Retry-After pour la limitation de débit. Ne renvoyez jamais de codes non officiels depuis votre propre API — les clients et les bibliothèques pourraient ne pas les comprendre.