HTTP-Header

Header enthalten alle Informationen zu einer Nachricht, die nicht deren Inhalt sind: den Absender (Authorization), das Format des Nachrichtentextes (Content-Type), das vom Client erwartete Antwortformat (Accept), die maximale Speicherdauer im Cache (Cache-Control), die Version (ETag) und den Zeitpunkt für einen erneuten Versuch (Retry-After). Bei den Namen wird nicht zwischen Groß- und Kleinschreibung unterschieden; die Werte sind Text.

So funktioniert es

Eine Anfrage oder Antwort besteht aus einer Startzeile, gefolgt von den Headern (einer pro Zeile), einer Leerzeile und dem eigentlichen Nachrichtentext. Zwischengeschaltete Systeme lesen und fügen Header hinzu, ohne den Nachrichtentext zu verändern – ein Proxy fügt beispielsweise Via hinzu, ein Load Balancer X-Forwarded-For und ein CDN seinen eigenen Cache-Status. Viele Verhaltensweisen, die wie API-Funktionen aussehen, sind in Wirklichkeit Konventionen für Header.

Das Missverständnis

Diese Überprüfung des Antworttextes ist ausreichend. Einige der gravierendsten Fehler befinden sich ausschließlich in den Headern: ein fehlender Location-Parameter nach einem 201-Statuscode, ein Cache-Control-Parameter, der es einem CDN ermöglicht, eine private Antwort zwischenzuspeichern, oder ein Content-Type-Wert von text/html in einem JSON-Antworttext. Sie bestehen jede Überprüfung des Antworttextes.

Probieren Sie es hier aus

Jede Antwort im Dokumentationsbereich zeigt ihre Header neben dem Body an, und die Assertionssprache liest sie mit headers.<name> — try headers.etag exists on GET /football/v1/standings.

Quellen

Weitere Begriffe

Inhaltsverhandlung — Client und Server einigen sich auf das Format der Antwort, und zwar über Header anstatt über separate URLs.
ETag — Eine undurchsichtige Versionskennung für eine Repräsentation, die dazu dient, ein erneutes Senden zu vermeiden und widersprüchliche Schreibvorgänge zu erkennen.
REST-API — Eine API, die ein System als adressierbare Ressourcen modelliert, die mit Standard-HTTP-Methoden manipuliert werden.
API-Endpunkt — Eine URL plus eine HTTP-Methode – die kleinste Einheit einer API, die ein Client aufrufen kann.
Abfrageparameter — Die Schlüssel-Wert-Paare nach dem Fragezeichen in einer URL dienen dazu, die Ergebnisse eines Endpunkts zu filtern, zu sortieren, zu paginieren oder zu strukturieren.
Pfadparameter — Ein variabler Abschnitt eines URL-Pfades, wie zum Beispiel die 42 in /orders/42 , der eine bestimmte Ressource identifiziert.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026