Accept

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der HTTP Accept-Anforderungsheader gibt an, welche Inhaltstypen, ausgedrückt als MIME-Typen, der Client verstehen kann. Der Server verwendet die Inhaltsaushandlung, um einen der Vorschläge auszuwählen und informiert den Client über die Auswahl mit dem Content-Type-Antwortheader. Browser legen die erforderlichen Werte für diesen Header basierend auf dem Kontext der Anforderung fest. Beispielsweise verwendet ein Browser unterschiedliche Werte in einer Anforderung beim Abrufen eines CSS-Stylesheets, Bildes, Videos oder eines Skripts.

Header-Typ Anforderungsheader
Verbotener Header-Name Nein
CORS-safelisted Anforderungsheader Ja*

* Werte dürfen keine CORS-unsafe request header bytes enthalten, einschließlich "():<>?@[\]{},, Delete 0x7F, und Steuerzeichen 0x00 bis 0x19, außer Tab 0x09.

Syntax

http
Accept: <media-type>/<MIME_subtype>
Accept: <media-type>/*
Accept: */*

// Multiple types, weighted with the quality value syntax
Accept: text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, */*;q=0.8

Direktiven

<media-type>/<subtype>

Ein einzelner, präziser Medientyp, wie text/html.

<media-type>/*

Ein Medientyp ohne Subtyp. Zum Beispiel entspricht image/* image/png, image/svg, image/gif und anderen Bildtypen.

*/*

Jeder Medientyp.

;q= (q-Faktor Gewichtung)

Ein Wert in der Reihenfolge der Präferenz, ausgedrückt mit einem relativen Qualitätswert, genannt das Gewicht.

Beispiele

Verwendung von Standard-Accept-Anforderungsheadern

HTTP-Anfragen, die mit Kommandozeilenwerkzeugen wie curl und wget gestellt werden, verwenden */* als Standardwert für Accept:

http
GET / HTTP/1.1
Host: example.com
User-Agent: curl/8.7.1
Accept: */*

Die Browser-Navigation hat typischerweise den folgenden Accept-Headerwert:

http
GET /en-US/ HTTP/2
Host: developer.mozilla.org
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
…

Nach Erhalt des Dokuments sehen die Standard-Accept-Werte in Anfragen für Bilder auf dem developer.mozilla.org Beispiel folgendermaßen aus:

http
Accept: image/avif,image/webp,image/png,image/svg+xml,image/*;q=0.8,*/*;q=0.5

Konfiguration von Accept-Anforderungsheadern für JSON-Antworten

Systeme, die eine API-Interaktion beinhalten, fordern häufig application/json-Antworten an. Hier ist ein Beispiel für eine GET-Anforderung, bei der der Client spezifisch eine JSON-Antwort anfordert:

http
GET /users/123 HTTP/1.1
Host: example.com
Authorization: Bearer abcd123
Accept: application/json

Spezifikationen

Specification
HTTP Semantics
# field.accept

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch