HTTP Status 404 - Not Found

Der HTTP-Status-Code 404 Not Found signalisiert, dass der Server die angefragte Resource nicht finden kann. Häufigster Client-Error in Web und APIs. Kann bedeuten, dass Resource nie existierte, gelöscht wurde oder URL falsch ist.

Typ

Response-Status-Code

Syntax

Der Status Code wird zurückgegeben, wenn Resource nicht existiert.

http
HTTP/1.1 404 Not Found

Direktiven

Der 404 Not Found Status Code wird verwendet, wenn Resource nicht existiert.

Resource Not Found
Server konnte keine Resource unter der angefragten URI finden. Resource existiert entweder nicht, wurde gelöscht oder URL-Path ist falsch.
Temporary vs Permanent
404 gibt keine Information, ob Resource jemals existierte oder ob Zustand temporary ist. Für explizit permanent gelöschte Resources kann 410 Gone verwendet werden.
Security Consideration
Manche APIs verwenden 404 statt 403 für unauthorized Resources, um Information Leakage zu vermeiden (Client kann nicht unterscheiden zwischen non-existent und forbidden).

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für Status 404.

Beispiel 1 Non-Existent API Resource

http
GET /api/users/99999 HTTP/1.1
Host: api.example.com

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": "not_found",
  "message": "User with ID 99999 not found",
  "resource_type": "User",
  "resource_id": "99999"
}

Beispiel 2 Invalid Endpoint Path

http
GET /api/nonexistent-endpoint HTTP/1.1
Host: api.example.com

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": "endpoint_not_found",
  "message": "The requested endpoint does not exist",
  "path": "/api/nonexistent-endpoint",
  "available_endpoints": "/api/docs"
}

Beispiel 3 Deleted Resource

http
GET /api/orders/archived-789 HTTP/1.1
Host: api.example.com

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": "resource_deleted",
  "message": "Order was permanently deleted",
  "deleted_at": "2025-09-15T10:30:00Z",
  "alternative": "Contact support for archived order retrieval"
}

Resource Not Found Flow

404 Not Found Response wenn Resource nicht in Database existiert

Vorteile für die Systemarchitektur

  • Clear Not-Found Semantics: Universal Error Code, den alle Clients verstehen. Unterscheidet sich klar von Server Errors (5xx) und anderen Client Errors (400, 403).
  • SEO Handling: Search Engines entfernen 404 URLs aus Index. Custom 404 Pages können User zu relevanten Content leiten, verbessern UX bei Broken Links.
  • Security via Obscurity: 404 kann für unauthorized Resources verwendet werden statt 403, verhindert Information Leakage über Resource-Existenz (Enumeration Attacks).

Spezifikation

RFC 9110, Section 15.5.5 – HTTP Semantics https://www.rfc-editor.org/rfc/rfc9110.html#name-404-not-found

Weitere Spezifikationen

HTTP Status 410 - Gone, HTTP Status 403 - Forbidden, GET Method