Codes de statut HTTP

Ce que propose la page Codes de statut HTTP

Codes de statut HTTP est une référence avec recherche pour les codes de réponse de 100 à 599. Elle aide à déboguer des appels d'API, à rédiger de la documentation, à choisir la réponse d'un nouvel endpoint, à lire des journaux, à examiner le comportement d'une passerelle ou à expliquer une défaillance à un autre développeur. Chaque entrée comprend le code numérique, la phrase de raison, la catégorie et une courte description de la signification habituelle de la réponse. Le filtre porte sur les codes, les noms, les catégories et les descriptions : vous pouvez donc chercher des valeurs exactes comme 404, de grands groupes comme redirect ou des notions comme cache, auth, proxy, timeout et validation.

La liste est intégrée directement à 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 pendant le débogage de problèmes réseau. Un clic sur un résultat copie le code et la phrase, pour les coller facilement dans des commentaires de tickets, de la documentation, des tests ou des notes d'endpoints.

Un flux de travail privé dans le navigateur

Tout le traitement s'effectue dans votre navigateur avec du JavaScript côté client. L'outil n'envoie à aucun serveur les extraits, valeurs de configuration, données générées, textes de requêtes ou exemples copiés, et ne nécessite aucun compte. Ce fonctionnement exclusivement local est important pour les utilitaires de développement, car les contenus qu'on y colle ressemblent souvent à de vraies données d'application : réponses d'API, journaux, exemples proches de variables d'environnement, requêtes de base de données, balisage de brouillons ou valeurs copiées lors de sessions de débogage en production. Garder la transformation en local réduit les risques et rend l'interaction rapide, puisqu'il n'y a aucun aller-retour réseau.

L'interface est volontairement compacte : vous collez l'entrée, ajustez les options, inspectez la sortie, la copiez et retournez dans votre éditeur. Les résultats doivent néanmoins être relus avant d'être validés dans un commit, partagés publiquement ou utilisés dans un flux de production. Les outils de navigateur sont excellents pour une inspection et une préparation rapides, mais ils ne peuvent pas connaître toutes les conventions d'un projet, règles de classification des données ou exigences de validation propres à une application.

Conseils pratiques

Les codes de statut font partie du contrat d'une API : choisissez-les avec soin. Utilisez les réponses de la famille 400 lorsque le client peut modifier sa requête, celles de la famille 500 lorsque le serveur n'a pas pu traiter une requête valide, et celles de la famille 300 lorsque le client doit aller voir ailleurs. Les échecs d'authentification et d'autorisation sont souvent confondus : 401 signifie généralement qu'une authentification est requise ou invalide, tandis que 403 signifie que l'appelant authentifié n'a pas le droit d'accéder à la ressource. Lorsque vous documentez une API, associez au code un schéma du corps de la réponse et des indications pour résoudre le problème.