HTTP HEAD Method

Die HTTP-Methode HEAD ist identisch zu GET, liefert jedoch nur Response-Header ohne Message-Body. Sie wird für Ressourcen-Validierung, Content-Length-Prüfung und Existenz-Tests verwendet ohne Bandbreite für Body-Download zu verschwenden.

Typ

HTTP-Methode

Syntax

HEAD-Request mit identischer Syntax zu GET-Request.

http 
HEAD /api/users/42 HTTP/1.1
Host: api.example.com

Direktiven

Die Direktiven definieren HEAD-Semantik und Response-Verhalten.

Identical to GET
Server muss identische Header wie bei GET-Request senden.
No Response Body
Response enthält keinen Message-Body, nur Status-Line und Header.
Content-Length
Header gibt Größe des Body an, der bei GET gesendet würde.
Safe and Idempotent
Verändert Server-State nicht, wiederholbar ohne Nebeneffekte.
Cacheable
HEAD-Responses können gecached werden wie GET-Responses.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für die HEAD-Methode.

Beispiel 1 Ressourcen-Existenz-Check

http 
HEAD /api/users/alice HTTP/1.1
Host: api.example.com
Authorization: Bearer token_abc

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 247
Last-Modified: Mon, 01 Oct 2025 09:30:00 GMT
ETag: "abc123"

Client prüft Existenz und Metadaten ohne vollständigen User-Datensatz zu laden.

Beispiel 2 File-Download-Vorbereitung

http 
HEAD /downloads/video.mp4 HTTP/1.1
Host: cdn.example.com

HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Length: 52428800
Accept-Ranges: bytes
Last-Modified: Sun, 30 Sep 2025 14:20:00 GMT

Download-Manager prüft Dateigröße (50 MB) und Range-Support vor Download-Start.

Beispiel 3 Cache-Validierung

http 
HEAD /api/data HTTP/1.1
Host: api.example.com
If-None-Match: "xyz789"

HTTP/1.1 304 Not Modified
ETag: "xyz789"
Cache-Control: max-age=3600

Client validiert gecachte Ressource ohne Body-Download, Server bestätigt Cache-Aktualität.

HEAD Method Use Case Flow

HEAD Method Ressourcen-Prüfung

Vorteile für die Systemarchitektur

  • Bandwidth-Einsparung: Metadaten-Abfrage ohne Body-Download spart Bandbreite bei großen Ressourcen
  • Existenz-Checks: Schnelle Ressourcen-Validierung für Health-Checks und Availability-Tests
  • Download-Optimierung: File-Size und Range-Support Prüfung vor großem Download

Spezifikation

RFC 9110, Section 9.3.2 – HTTP Semantics https://www.rfc-editor.org/rfc/rfc9110.html#name-head

Weitere Spezifikationen

GET Method, HTTP Status 200 - OK, Content-Length Header