Codes HTTP

Référence des codes de statut HTTP

Outils développeur

Comment utiliser Codes HTTP

  1. 1Recherchez un numéro de code ou un mot-clé
  2. 2Parcourez par catégorie (2xx, 3xx, etc.)
  3. 3Cliquez sur n'importe quel code pour les détails complets

À propos de Codes HTTP

Codes de statut HTTP est une référence complète pour tous les codes de statut de réponse HTTP standard et couramment utilisés, organisés par catégorie. Chaque code inclut une description en langage simple, quand il est approprié de l'utiliser, et des exemples de scénarios du monde réel.

Les codes de statut HTTP sont le principal mécanisme par lequel les serveurs communiquent le résultat d'une requête. Chaque développeur travaillant avec les API REST doit savoir ce que signifient 200, 201, 204, 301, 400, 401, 403, 404, 422, 429 et 500.

Recherchez ou filtrez par numéro de code, catégorie (1xx-5xx) ou mot-clé pour trouver instantanément n'importe quel code.

Fonctionnalités clés de Codes HTTP

  • Référence complète pour tous les codes de statut HTTP standard (1xx-5xx)
  • Inclut les codes non standard mais largement utilisés : 418, 429, 451
  • Description en langage simple pour chaque code
  • Recherche par numéro de code ou mot-clé
  • Filtre par catégorie : 1xx Informatif, 2xx Succès, 3xx Redirection, 4xx Erreur client, 5xx Erreur serveur
  • Cas d'utilisation courants et exemples pour chaque code
  • Fonctionne entièrement dans le navigateur — aucune requête serveur
  • Recherche instantanée rapide sans délai de chargement

Exemples

Trouver le code correct pour une création de ressource réussie

Trouver quel code 2xx retourner depuis un endpoint POST qui crée une nouvelle ressource.

Entrée

Recherche: "created" ou code 201

Sortie

201 Created — Utilisé quand une nouvelle ressource a été créée. Incluez un en-tête Location pointant vers l'URL de la nouvelle ressource.

Trouver le bon code d'erreur pour une réponse API limitée en débit

Identifier le code standard pour communiquer qu'un client a dépassé les limites de débit API.

Entrée

Recherche: "rate limit" ou code 429

Sortie

429 Too Many Requests — Incluez un en-tête Retry-After indiquant quand le client peut réessayer.

Cas d'utilisation courants

  • Recherche du code de statut correct à retourner depuis un endpoint API REST
  • Débogage des erreurs HTTP en comprenant ce que signifie un code spécifique
  • Conception de la gestion des erreurs dans le code client API pour différentes catégories de réponse
  • Apprentissage de la sémantique HTTP lors de la construction ou documentation d'une API
  • Révision des conceptions API pour vérifier que les codes de statut sont utilisés de manière appropriée
  • Référence rapide pendant le développement sans quitter votre onglet de navigateur

Dépannage

Utilisation de 200 OK pour toutes les réponses y compris les erreurs

Solution

Utilisez toujours le code de statut sémantiquement correct. Retourner 200 avec une erreur dans le corps casse la sémantique HTTP.

Confusion entre 401 et 403

Solution

401 Non autorisé signifie que le client n'est pas authentifié. 403 Interdit signifie que le client est authentifié mais manque de permission.

Utilisation de 404 pour les échecs d'authentification

Solution

Retourner 404 pour les ressources protégées est une technique de sécurité pour empêcher l'énumération, mais cela peut confondre les clients légitimes. Documentez clairement votre choix.

Questions fréquemment posées

Tous les codes de statut HTTP sont-ils listés ?

Oui. Tous les codes de statut RFC 7231 standard plus les codes non officiels couramment utilisés comme 418 (I'm a Teapot), 429 (Too Many Requests) et 451 (Unavailable for Legal Reasons) sont inclus.

Quelle est la différence entre 401 et 403 ?

401 Non autorisé indique que la requête nécessite une authentification. 403 Interdit indique que le serveur comprend la requête mais refuse de l'autoriser.

Quand utiliser 200 vs 201 vs 204 ?

200 OK pour les requêtes GET réussies, 201 Created pour les requêtes POST réussies qui créent une ressource, 204 No Content pour DELETE ou PATCH ne retournant pas de corps.

Que signifie 422 Unprocessable Entity ?

422 indique que la requête était bien formée mais sémantiquement incorrecte. Courant dans les API REST pour les erreurs de validation.

Quel est le code de statut correct pour une redirection ?

301 Moved Permanently pour les changements d'URL permanents, 302 Found pour les redirections temporaires, et 307/308 pour préserver la méthode HTTP lors de la redirection.

Quand retourner 503 plutôt que 500 ?

500 Internal Server Error indique une défaillance inattendue. 503 Service Unavailable indique que le serveur est temporairement incapable de gérer les requêtes.

Mes données sont-elles envoyées à un serveur ?

Non. La référence des codes de statut est chargée statiquement dans votre navigateur. Aucune requête ni interaction n'est transmise.

Que signifie la plage de codes de statut 1xx ?

Les codes 1xx sont informatifs — ils indiquent que la requête a été reçue et que le traitement continue. Le plus courant est 100 Continue.