Développeur

Codes de statut HTTP

Cherchez un code HTTP : signification et quand l’utiliser.

  • Instantané
  • Gratuit
  • Privé (traité localement)
  • Sans inscription
200OK
Succès

La requête a réussi.

201Created
Succès

Ressource créée avec succès.

202Accepted
Succès

Acceptée, traitement en cours.

204No Content
Succès

Succès, sans contenu à renvoyer.

206Partial Content
Succès

Contenu partiel (reprise, streaming).

301Moved Permanently
Redirection

Déplacé définitivement, nouvelle URL.

302Found
Redirection

Redirection temporaire.

304Not Modified
Redirection

Non modifié, utilisez le cache.

307Temporary Redirect
Redirection

Redirection temporaire, méthode conservée.

308Permanent Redirect
Redirection

Redirection permanente, méthode conservée.

400Bad Request
Erreur client

Requête malformée côté client.

401Unauthorized
Erreur client

Authentification requise ou échouée.

403Forbidden
Erreur client

Accès interdit, droits insuffisants.

404Not Found
Erreur client

Ressource introuvable.

405Method Not Allowed
Erreur client

Méthode HTTP non autorisée ici.

409Conflict
Erreur client

Conflit avec l’état actuel.

410Gone
Erreur client

Ressource supprimée définitivement.

418I'm a teapot
Erreur client

Je suis une théière (blague d’avril).

422Unprocessable Entity
Erreur client

Données valides en syntaxe, mais non traitables.

429Too Many Requests
Erreur client

Trop de requêtes, ralentissez.

500Internal Server Error
Erreur serveur

Erreur interne du serveur.

501Not Implemented
Erreur serveur

Fonctionnalité non implémentée.

502Bad Gateway
Erreur serveur

Réponse invalide d’un serveur amont.

503Service Unavailable
Erreur serveur

Service indisponible (surcharge, maintenance).

504Gateway Timeout
Erreur serveur

Délai dépassé avec un serveur amont.

Le dictionnaire des codes HTTP, à portée de recherche

Quand une requête web échoue, le serveur renvoie un code à trois chiffres. Cet outil les rassemble et les explique : tapez un numéro (404) ou un intitulé (« not found »), filtrez par classe, et lisez la signification et le bon usage de chaque code.

  1. Cherchez

    Par numéro, par intitulé, ou par classe (« 4 » pour les 4xx).

  2. Lisez la fiche

    Code, intitulé officiel, catégorie et description.

  3. Choisissez le bon code

    Pour votre API, votre redirection ou votre page d’erreur.

Les quatre grandes familles

ClasseSensExemples
2xxSuccès200 OK, 201 Created, 204 No Content
3xxRedirection301 Moved, 302 Found, 304 Not Modified
4xxErreur client400, 401, 403, 404, 429
5xxErreur serveur500, 502, 503, 504

Réflexe de débogage : le premier chiffre indique le camp. Un 4xx, c’est à corriger côté requête (URL, droits, format) ; un 5xx, côté serveur (code, configuration, surcharge).

Questions fréquentes

Que signifient les classes 2xx, 3xx, 4xx, 5xx ?

Le premier chiffre indique la catégorie : 2xx = succès, 3xx = redirection, 4xx = erreur côté client (votre requête), 5xx = erreur côté serveur. Un coup d’œil au premier chiffre dit déjà à qui « appartient » le problème.

Quelle différence entre 401 et 403 ?

401 (Unauthorized) signifie « identifie-toi » : l’authentification manque ou a échoué. 403 (Forbidden) signifie « je sais qui tu es, mais tu n’as pas le droit ». Le premier se résout en se connectant, le second non.

Quand utiliser 301 plutôt que 302 ?

301 (Moved Permanently) pour un déménagement définitif : les moteurs de recherche transfèrent le référencement vers la nouvelle URL. 302 (Found) pour un déplacement temporaire : l’ancienne URL reste la référence. Se tromper nuit au SEO.

Le code 418 existe-t-il vraiment ?

Oui ! 418 « I’m a teapot » vient d’un poisson d’avril de 1998 (protocole de cafetières). Il n’a aucun usage sérieux mais est devenu une blague culte, et certains serveurs le renvoient pour des requêtes farfelues.