Der HTTP-Accept-Request- undResponse-Header gibt an, welche Inhaltsarten, ausgedrückt alsMIME-Typen, der Absender verstehen kann. Bei Anfragen verwendet der ServerContent Negotiation, um einen der Vorschläge auszuwählen und informiert den Client über die Auswahl mit demContent-Type-Response-Header. In Antworten gibt der Header an, welche Inhaltsarten der Server in Nachrichten zur angeforderten Ressource verstehen kann, sodass diese Inhaltsart bei nachfolgenden Anfragen an die Ressource verwendet werden kann.

Browser setzen erforderliche Werte für diesen Header basierend auf dem Kontext der Anfrage. Beispielsweise verwendet ein Browser unterschiedliche Werte in einer Anfrage, wenn ein CSS-Stylesheet, Bild, Video oder ein Skript abgerufen wird.

* Werte dürfen keineCORS-unsicheren Anfrage-Header-Bytes enthalten, einschließlich"():<>?@[\]{},, Delete0x7F und Steuerzeichen0x00 bis0x19, außer Tab0x09.

Syntax

Accept: <media-type>/<MIME_subtype>Accept: <media-type>/*Accept: */*// Multiple types, weighted with the quality value syntaxAccept: text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, */*;q=0.8

Direktiven

<media-type>/<subtype>

Ein einzelner, präziserMedientyp, wietext/html.

<media-type>/*

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

*/*

Jeder Medientyp.

;q= (q-Faktor Gewichtung)

Ein Wert der Präferenzordnung, ausgedrückt mithilfe eines relativenQualitätswertes, genannt dasGewicht.

Beispiele

Verwenden der Standard-Accept-Anfrage-Header

HTTP-Anfragen, die mit Befehlszeilentools wiecurl undwget erstellt werden, verwenden*/* als Standardwert fürAccept:

GET / HTTP/1.1Host: example.comUser-Agent: curl/8.7.1Accept: */*

Die Browsenavigation hat typischerweise den folgendenAccept-Anfrage-Header-Wert:

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

Nach dem Empfang des Dokuments sehen die Standard-Accept-Werte in Anfragen für Bilder auf dem Beispieldeveloper.mozilla.org so aus:

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

Konfigurieren von Accept-Anfrage-Headern für JSON Antworten

Systeme, die API-Interaktion beinhalten, fordern typischerweiseapplication/json-Antworten an. Hier ist ein Beispiel für eineGET-Anfrage, bei der der Client spezifisch eine JSON-Antwort anfordert:

GET /users/123 HTTP/1.1Host: example.comAuthorization: Bearer abcd123Accept: application/json

Spezifikationen

Browser-Kompatibilität

Siehe auch

• HTTPContent Negotiation
• Liste der Standardwerte für Accept
• CORS-Safelist-Anfrage-Header-Einschränkungen
• Ein Header mit dem Ergebnis der Content Negotiation:Content-Type
• Andere ähnliche Header:TE,Accept-Encoding,Accept-Language