Accept
Verwendung
Der Accept-Header steuert die Inhaltsaushandlung (Content Negotiation). Ein Client sendet eine nach Präferenz geordnete Liste von Medientypen, und der Server wählt aus den für die angeforderte Ressource verfügbaren Repräsentationen die beste Übereinstimmung aus.
Browser setzen diesen Header anhand des Anfragekontexts automatisch. Eine Navigationsanfrage fordert typischerweise text/html an, während ein Bildelement gängige Bildformate anfordert. API-Clients senden häufig application/json oder application/xml.
Wenn der Server über keine Repräsentation verfügt, die einem der aufgeführten Typen entspricht, lautet die erwartete Antwort 406 Not Acceptable. In der Praxis ignorieren viele Server den Header und liefern stattdessen die Standardrepräsentation aus.
Hinweis
Der Accept-Header ist nicht erforderlich. Lässt man ihn weg, bedeutet das, dass der Client jeden beliebigen Medientyp akzeptiert (/). Browser senden / als Rückfalloption, und viele Server ignorieren Accept vollständig und geben unabhängig von der Client-Präferenz einen festen Content-Type zurück.
media-type/subtype
Ein konkreter Medientyp wie text/html oder application/json. Der Server behandelt das vollständige Paar aus type/subtype als eindeutige Präferenz.
media-type/*
Ein Platzhalter-Subtyp. image/* signalisiert die Akzeptanz beliebiger Bildformate, sei es image/png, image/webp oder image/avif.
*/*
Akzeptiert jeden beliebigen Medientyp. Dieser Platzhalter dient als Rückfalloption, wenn kein anderer Typ passt.
;q= (Qualitätswert)
Ein Gewicht zwischen 0 und 1, das die relative Präferenz ausdrückt. Höhere Werte stehen für eine stärkere Präferenz. Wird es weggelassen, beträgt das Standardgewicht 1.0. Ein Wert von 0 bedeutet, dass der Typ nicht akzeptabel ist.
Beispiel
Ein Browser, der eine HTML-Seite anfordert, sendet mehrere nach Qualitätswert geordnete Medientypen. Der am höchsten gewichtete Typ, den der Server unterstützt, setzt sich durch.
Accept: text/html, application/xhtml+xml, */*;q=0.8Ein API-Client, der JSON mit XML als Rückfalloption anfordert, weist XML einen niedrigeren Qualitätswert zu.
Accept: application/json, application/xml;q=0.9Ein KI-Agent fordert eine Seite in Markdown an, um den Token-Verbrauch zu senken, mit HTML als Rückfalloption.
Accept: text/markdown, text/html;q=0.9KI-Agenten und Inhaltsaushandlung
CDN-Anbieter wie Cloudflare wandeln HTML-Seiten spontan in Markdown um, wenn eine Anfrage Accept: text/markdown enthält. Die Umwandlung senkt die Token-Anzahl um bis zu 80 % und macht die Inhaltsaushandlung damit zu einer praxistauglichen Optimierung für LLM-basierte Agenten und Crawler.
Ein API-Client, der strukturierte Fehlerantworten anfordert, verwendet application/problem+json neben dem regulären Inhaltstyp. Der Server gibt bei Fehlern Problemdetails und bei erfolgreichen Antworten JSON zurück.
Accept: application/problem+json, application/jsonEine Anfrage, die mehrere Textformate mit expliziten Prioritäten auflistet. text/html trägt das Standardgewicht 1.0, text/plain folgt mit 0.9, jedes andere Textformat mit 0.8 und alles Übrige mit 0.7.
Accept: text/html, text/plain;q=0.9, text/*;q=0.8, */*;q=0.7Hinweis
Teilen sich zwei Typen denselben Qualitätswert, hat der spezifischere Typ Vorrang. Tragen sowohl text/html als auch text/* das Gewicht 1.0, wählt der Server text/html.