HTTP Save-Data Header

Der HTTP-Header Save-Data ist ein Client Hint Request-Header, der signalisiert, dass der Client Datenübertragung minimieren möchte. APIs können darauf reagieren mit reduzierten Payloads, kleineren Bildern, oder optimierten Responses für mobile Nutzer mit begrenztem Datenvolumen.

Typ

Request-Header (Client Hint)

Syntax

Der Header hat einen einzelnen Boolean-Wert für Data-Saver-Modus.

http
Save-Data: on

Direktiven

Der Header hat eine einzelne Direktive für Bandwidth-Präferenz.

on
Client möchte Datenübertragung minimieren. Server sollten kleinere Responses senden. Wert ist immer on wenn Header präsent ist.

Beispiele

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

Beispiel 1 Reduzierte API-Response für Mobile Client

http
GET /api/products?category=laptops HTTP/1.1
Host: api.example.com
Save-Data: on
RTT: 450
Downlink: 0.7

Server erkennt Data-Saver-Modus und sendet minimalen Response.

http
HTTP/1.1 200 OK
Content-Type: application/json
Vary: Save-Data
Content-Encoding: br

{
  "products": [
    {"id": 1, "name": "Laptop Pro", "price": 1299},
    {"id": 2, "name": "Laptop Air", "price": 999}
  ],
  "images_omitted": true,
  "full_version": "/api/products?category=laptops&full=1"
}

Beispiel 2 Conditional Image URLs basierend auf Save-Data

http
GET /api/articles/12345 HTTP/1.1
Host: api.example.com
Save-Data: on

Server sendet Thumbnail-URLs statt Full-Size-Bilder.

http
HTTP/1.1 200 OK
Content-Type: application/json
Vary: Save-Data

{
  "id": 12345,
  "title": "API Best Practices 2024",
  "thumbnail": "https://cdn.example.com/thumbs/article-12345-small.jpg",
  "content": "...",
  "full_image_available": true
}

Beispiel 3 Pagination mit kleineren Page-Sizes

http
GET /api/users HTTP/1.1
Host: api.example.com
Save-Data: on

Server reduziert Default-Page-Size für Data-Saver-Clients.

http
HTTP/1.1 200 OK
Content-Type: application/json
Link: </api/users?page=2&limit=10>; rel="next"
Vary: Save-Data

{
  "users": [
    {"id": 1, "name": "Alice"},
    {"id": 2, "name": "Bob"},
    ...
  ],
  "page_size": 10,
  "note": "Reduced page size for save-data mode"
}

Adaptive Response Flow

Adaptive API-Response mit Save-Data Header

Vorteile für die Systemarchitektur

Save-Data ermöglicht bandwidth-bewusste APIs mit optimaler User Experience für alle Netze.

  • Mobile-Friendly: APIs können automatisch für langsame Verbindungen optimieren
  • Cost-Awareness: Nutzer mit limitierten Datenplänen profitieren von reduzierten Payloads
  • Progressive Enhancement: Clients können Full-Responses optional nachladen bei Bedarf

Spezifikation

Save-Data Client Hint (IETF Internet-Draft) https://datatracker.ietf.org/doc/html/draft-grigorik-http-client-hints-03

Weitere Spezifikationen

ECT Header, Downlink Header