Codes de statut HTTP : Guide de référence complet pour les développeurs

Les codes de statut HTTP sont des nombres à trois chiffres renvoyés par un serveur. Comprendre ces codes est essentiel pour déboguer les API et résoudre les problèmes réseau. Ce guide complet des codes HTTP couvre tous les codes que vous rencontrerez.

Consultez n'importe quel code HTTP avec notre outil →

1xx — Informationnel

Ces codes indiquent que le serveur a reçu la requête et continue de la traiter.

2xx — Succès

La catégorie la plus courante. Ces codes indiquent que la requête a été traitée avec succès.

3xx — Redirection

Ces codes indiquent que le client doit effectuer une action supplémentaire.

4xx — Erreurs client

Ces codes indiquent un problème du côté du client.

5xx — Erreurs serveur

Ces codes indiquent que le serveur n'a pas pu traiter la requête.

Bonnes pratiques pour les codes API

Choisir le bon code rend votre API plus intuitive.

// REST API Status Code Guidelines

// Creating a resource
POST /api/users → 201 Created (with Location header)

// Successful read
GET /api/users/123 → 200 OK

// Successful update
PUT /api/users/123 → 200 OK (with updated resource)
PATCH /api/users/123 → 200 OK

// Successful delete
DELETE /api/users/123 → 204 No Content

// Validation error
POST /api/users (invalid data) → 422 Unprocessable Entity
{
  "error": "Validation failed",
  "details": [
    { "field": "email", "message": "Invalid email format" }
  ]
}

// Authentication required
GET /api/admin → 401 Unauthorized
{ "error": "Authentication required" }

// No permission
GET /api/admin (as regular user) → 403 Forbidden
{ "error": "Insufficient permissions" }

// Resource not found
GET /api/users/999 → 404 Not Found
{ "error": "User not found" }

// Rate limit exceeded
GET /api/search → 429 Too Many Requests
Retry-After: 60
{ "error": "Rate limit exceeded", "retry_after": 60 }

Scénarios de débogage courants

Les codes HTTP sont votre premier indice lors du débogage.

CORS Errors (Browser shows "blocked by CORS")

The browser blocks the request, but the actual HTTP status may be hidden. Check server logs. Ensure your server sends the correct Access-Control-Allow-Origin, Access-Control-Allow-Methods, and Access-Control-Allow-Headers headers.

502 Bad Gateway on Deployment

Your reverse proxy (Nginx, Cloudflare) can't reach your application server. Check: Is the app process running? Is it listening on the correct port? Are there firewall rules blocking the connection?

# Check if your app is running
ps aux | grep node

# Check if it's listening on the expected port
netstat -tlnp | grep 3000

# Check Nginx error logs
tail -f /var/log/nginx/error.log

504 Gateway Timeout

The upstream server is too slow. Common causes: slow database queries, external API timeouts, or large file processing. Solutions: optimize queries, add timeouts to external calls, use background jobs for heavy tasks.

429 Rate Limiting

// Implementing exponential backoff in JavaScript
async function fetchWithRetry(url, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url);
    if (response.status !== 429) return response;

    const retryAfter = response.headers.get('Retry-After');
    const delay = retryAfter
      ? parseInt(retryAfter) * 1000
      : Math.pow(2, i) * 1000; // 1s, 2s, 4s

    await new Promise(r => setTimeout(r, delay));
  }
  throw new Error('Max retries exceeded');
}

Questions fréquentes

Quelle différence entre 401 et 403 ?

401 = authentification manquante. 403 = authentifié mais pas autorisé.

Quand utiliser 200 vs 201 ?

200 pour les requêtes réussies, 201 quand une nouvelle ressource est créée.

Que signifie 418 I'm a Teapot ?

Un poisson d'avril de 1998 (RFC 2324). Le serveur refuse de faire du café car c'est une théière.

Différence entre 301 et 302 pour le SEO ?

301 = redirection permanente (transfère le SEO). 302 = temporaire (garde l'URL originale).

Comment gérer le 429 ?

Vérifiez l'en-tête Retry-After et implémentez un backoff exponentiel.

Comprendre les codes HTTP est fondamental. Utilisez notre outil pour chercher rapidement tout code.

Consultez les codes avec notre outil HTTP →