WebGroundwebground.app
Infos & Guides · Référence Web

Référence des Codes de Statut HTTP

Aide-mémoire consultable des codes HTTP 1xx–5xx, significations et conseils de débogage pour API et CDN.

Affichage de 26 codes
100

Continue

En-têtes initiaux reçus ; le client peut poursuivre l'envoi du corps de requête.

Astuce : Fréquent lors d'envois volumineux avec l'en-tête Expect: 100-continue.

101

Switching Protocols

Le serveur accepte de changer de protocole, le plus souvent vers WebSocket.

Astuce : Vérifiez les en-têtes Upgrade et Connection si la négociation WebSocket échoue.

200

OK

Réponse standard confirmant le succès de la requête HTTP.

Astuce : Contrôlez Content-Type et la structure JSON si l'interface échoue au rendu.

201

Created

La requête a réussi et créé une ou plusieurs nouvelles ressources.

Astuce : Les API REST renvoient souvent un en-tête Location vers la nouvelle ressource.

204

No Content

Requête réussie ; le serveur renvoie délibérément un corps vide.

Astuce : Évitez response.json() sur un statut 204 (fréquent sur DELETE ou OPTIONS).

206

Partial Content

Le serveur n'a transmis que la plage d'octets demandée.

Astuce : Utilisé pour le streaming vidéo et les téléchargements reprenables via Range.

301

Moved Permanently

Ressource déplacée définitivement vers une autre URL ; le SEO est transféré.

Astuce : Les navigateurs mettent 301 fortement en cache — testez en navigation privée ou curl -I.

302

Found (Redirection temporaire)

Ressource servie temporairement ailleurs tout en gardant l'URL d'origine indexée.

Astuce : Courant dans les flux OAuth ou bascules temporaires de maintenance.

304

Not Modified

La copie en cache reste valide selon les en-têtes ETag ou Last-Modified.

Astuce : Économise la bande passante ; vérifiez Cache-Control si des fichiers obsolètes restent.

307

Temporary Redirect

Redirection temporaire préservant strictement la méthode HTTP et le corps.

Astuce : Préférez 307 à 302 lorsqu'un POST doit rester un POST après redirection.

308

Permanent Redirect

Redirection permanente conservant la méthode HTTP et le corps d'origine.

Astuce : Courant pour les redirections de slash final Next.js et canonisation HTTPS.

400

Bad Request

Le serveur ne peut traiter la requête en raison d'une syntaxe ou de paramètres invalides.

Astuce : Validez le JSON, les champs requis et l'en-tête Content-Type.

401

Unauthorized

Authentification absente, expirée ou invalide pour cet endpoint.

Astuce : Contrôlez l'expiration du jeton Bearer, la clé API ou les cookies de session.

403

Forbidden

Le client est identifié (ou bloqué par politique) mais n'a pas la permission.

Astuce : Vérifiez les rôles RBAC, règles CORS/WAF ou permissions de stockage.

404

Not Found

Le serveur ne trouve pas la route ou la ressource demandée.

Astuce : Vérifiez les slashs finaux, le chemin de base, le DNS ou les ID supprimés.

405

Method Not Allowed

L'endpoint existe mais n'accepte pas la méthode HTTP utilisée (ex. GET au lieu de POST).

Astuce : Inspectez l'en-tête Allow pour connaître les méthodes autorisées.

408

Request Timeout

Le client a mis trop de temps à transmettre la requête avant fermeture du socket.

Astuce : Examinez les envois lents sur réseau mobile ou les délais keep-alive.

409

Conflict

La requête entre en conflit avec l'état actuel de la ressource cible.

Astuce : Fréquent sur inscription d'e-mail déjà existant ou conflit d'ETag.

413

Content Too Large

La taille de la requête dépasse la limite du serveur ou du proxy inverse.

Astuce : Compressez les images côté client ou augmentez la taille maximale sur le proxy.

415

Unsupported Media Type

Le serveur refuse le format indiqué dans l'en-tête Content-Type.

Astuce : Vérifiez que Content-Type: application/json ou multipart/form-data correspond au corps.

422

Unprocessable Content

Syntaxe valide (ex. JSON correct), mais échec de validation sémantique des champs.

Astuce : Inspectez les détails d'erreur (e-mail invalide, valeur négative ou champ manquant).

429

Too Many Requests

Le client a dépassé la limite de débit (rate limit) de l'API.

Astuce : Respectez l'en-tête Retry-After et utilisez un backoff exponentiel avec jitter.

500

Internal Server Error

Une exception non gérée est survenue sur le serveur d'origine.

Astuce : Consultez les journaux serveur, variables d'environnement ou erreurs de base de données.

502

Bad Gateway

Le proxy, CDN ou répartiteur a reçu une réponse invalide du serveur amont.

Astuce : Vérifiez que le processus applicatif amont tourne et écoute sur le bon port.

503

Service Unavailable

Le serveur est temporairement surchargé ou en maintenance planifiée.

Astuce : Surveillez Retry-After, les sondes de santé ou l'épuisement au démarrage à froid.

504

Gateway Timeout

Le proxy ou CDN a expiré en attendant la réponse du serveur amont.

Astuce : Optimisez les requêtes lentes ou déportez les traitements longs en file asynchrone.

Vous débuggez une erreur 400 Bad Request ou une charge JSON d'API ?Ouvrir le formateur JSON

Comprendre les cinq classes de codes HTTP

Chaque réponse HTTP débute par un code à trois chiffres défini par la RFC 9110. Les regrouper par premier chiffre aide développeurs, DevOps et équipes SEO à diagnostiquer un incident en quelques secondes.

En résumé : 1xx signale un échange protocolaire, 2xx confirme le succès, 3xx indique cache ou redirection, 4xx pointe une erreur côté client et 5xx une défaillance du serveur d'origine ou passerelle.

Pièges fréquents en production

Distinguer les codes voisins évite bien des erreurs difficiles à tracer :

  • 401 Unauthorized vs 403 Forbidden : 401 signifie identifiants manquants ou expirés ; 403 indique un client identifié (ou bloqué par règle) sans autorisation.
  • 301/302 vs 307/308 : les anciennes redirections 301/302 peuvent transformer un POST en GET, alors que 307 et 308 conservent méthode et corps.
  • 502 Bad Gateway vs 504 Gateway Timeout : 502 traduit une réponse invalide du serveur amont, tandis que 504 signifie un délai d'attente dépassé.

Questions fréquentes

Quelle différence entre 401 et 403 ?+

401 Unauthorized indique une authentification absente, expirée ou invalide. 403 Forbidden signifie que le serveur refuse l'accès faute de droits ou par politique de sécurité.

Comment gérer une réponse 429 Too Many Requests ?+

Respectez l'en-tête Retry-After lorsqu'il est présent et implémentez un backoff exponentiel avec jitter aléatoire.

Pourquoi 204 No Content fait-il échouer response.json() en JavaScript ?+

Une réponse 204 possède volontairement un corps vide ; appeler response.json() provoque une erreur d'analyse. Vérifiez response.status === 204 au préalable.

Explorer plus sur WebGround

Tout voir