HTTP Pragma Header

Der HTTP-Header Pragma ist ein veralteter Request-Header aus HTTP/1.0, der Cache-Direktiven an den Server sendet. Moderne APIs sollten stattdessen den Cache-Control Header verwenden, aber Pragma wird für Rückwärtskompatibilität mit älteren Clients weiterhin unterstützt.

Typ

Request-Header

Syntax

Der Header unterstützt primär die no-cache Direktive für Cache-Umgehung.

http 
Pragma: no-cache

Direktiven

Die Direktive steuert das Caching-Verhalten für HTTP/1.0 Proxies und Caches.

no-cache
Fordert den Server auf, keine gecachte Antwort zu verwenden und eine frische Ressource vom Origin-Server zu holen.
<custom-directive>
Nicht standardisierte Direktiven können implementierungsabhängig unterstützt werden, haben aber keine garantierte Wirkung.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Pragma-Header.

Beispiel 1 Cache-Umgehung für HTTP 1.0

http 
GET /api/users/12345 HTTP/1.0
Pragma: no-cache
Host: api.example.com

Legacy-Client fordert explizit eine frische Antwort vom Origin-Server, ohne Caching-Zwischenstufen.

Beispiel 2 Kombination mit Cache-Control für maximale Kompatibilität

http 
GET /api/orders/67890 HTTP/1.1
Cache-Control: no-cache
Pragma: no-cache
Host: api.example.com

Moderner Client sendet beide Header für Kompatibilität mit HTTP/1.0 und HTTP/1.1 Proxies.

Beispiel 3 Server-Antwort ignoriert Pragma in HTTP 1.1

http 
HTTP/1.1 200 OK
Cache-Control: max-age=3600
Content-Type: application/json

{"id": 67890, "status": "shipped"}

HTTP/1.1 Server verwendet ausschließlich Cache-Control für Caching-Steuerung, Pragma wird ignoriert.

Cache-Bypass Flow

Legacy Cache-Bypass mit Pragma Header

Vorteile für die Systemarchitektur

Der Legacy-Support bietet begrenzte architektonische Vorteile für moderne APIs.

  • Rückwärtskompatibilität: Unterstützt sehr alte HTTP/1.0 Clients, die nur Pragma kennen
  • Dual-Header-Strategie: Kombination mit Cache-Control deckt alle HTTP-Versionen ab

Spezifikation

RFC 9111, Section 5.4 – HTTP Caching https://www.rfc-editor.org/rfc/rfc9111.html#name-pragma

Weitere Spezifikationen

Cache-Control Header, Expires Header