Accept-Ranges

Verwendung

Der Accept-Ranges-Header teilt Clients mit, dass der Server Range-Anfragen akzeptiert, und ermöglicht damit Teil-Downloads einer Ressource. Das ist unverzichtbar, um unterbrochene Dateiübertragungen fortzusetzen, Medien ab einer bestimmten Position zu streamen und Abschnitte großer Dateien bei Bedarf abzurufen.

Sendet ein Client eine Range-Anfrage, gibt der Server eine Antwort mit 206 Partial Content zurück, die nur den angeforderten Byte-Abschnitt enthält. Der Antwort-Header Content-Range gibt den genauen Byte-Bereich und die Gesamtgröße der Ressource an.

Ist der angeforderte Bereich ungültig oder liegt er außerhalb der Grenzen der Ressource, antwortet der Server mit 416 Range Not Satisfiable.

bytes

Der Server akzeptiert Anfragen mit Byte-Bereichen. Dies ist die einzige von HTTP definierte Bereichseinheit und der häufigste Wert für diesen Header.

none

Der Server unterstützt für diese Ressource keine Range-Anfragen. Das explizite Senden von none rät Clients davon ab, Range-Anfragen zu versuchen.

Beispiel

Ein Server, der Unterstützung für Byte-Bereichsanfragen signalisiert. Download-Manager und Mediaplayer nutzen dieses Signal, um bestimmte Teile einer Datei anzufordern.

Accept-Ranges: bytes

Ein Server, der Range-Anfragen ausdrücklich deaktiviert. Clients, die diesen Wert erhalten, laden die vollständige Ressource in einer einzigen Anfrage herunter.

Accept-Ranges: none

Eine typische Antwort für eine herunterladbare Datei, die den Hinweis auf Bereichsunterstützung mit der Inhaltslänge kombiniert. Ein bei Byte 5000 unterbrochener Client setzt ab der Abbruchstelle fort.

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Length: 1048576
Content-Type: application/octet-stream