HTTP-Statuscodes: Vollständige Referenz für Entwickler

HTTP-Statuscodes sind dreistellige Zahlen, die ein Server als Antwort zurückgibt. Dieser vollständige HTTP-Statuscode-Referenz deckt alle Codes ab, die Sie in der Praxis antreffen.

Schlagen Sie jeden HTTP-Statuscode mit unserem Tool nach →

1xx — Informativ

Diese Codes zeigen an, dass der Server die Anfrage empfangen hat.

2xx — Erfolg

Die häufigste Kategorie. Die Anfrage wurde erfolgreich verarbeitet.

3xx — Umleitung

Der Client muss eine weitere Aktion durchführen.

4xx — Client-Fehler

Das Problem liegt auf der Client-Seite.

5xx — Server-Fehler

Der Server konnte die Anfrage nicht erfüllen.

Best Practices für API-Statuscodes

Der richtige Statuscode macht Ihre API intuitiver.

// 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 }

Häufige Debug-Szenarien

Statuscodes sind Ihr erster Hinweis beim Debugging.

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');
}

Häufige Fragen

Unterschied zwischen 401 und 403?

401 = Authentifizierung fehlt. 403 = authentifiziert, aber nicht berechtigt.

Wann 200 vs 201?

200 für erfolgreiche Anfragen, 201 bei neuer Ressource.

Was bedeutet 418?

Ein Aprilscherz von 1998. Der Server ist eine Teekanne.

301 vs 302 für SEO?

301 = permanent (überträgt SEO). 302 = temporär.

Wie mit 429 umgehen?

Retry-After-Header prüfen und exponentiellen Backoff implementieren.

HTTP-Statuscodes zu verstehen ist grundlegend. Nutzen Sie unser Tool.

Codes nachschlagen mit unserem HTTP-Tool →