Accept-Language

Verwendung

Der Accept-Language-Header ist Teil der Inhaltsaushandlung. Ein Client sendet eine nach Priorität geordnete Liste von Sprach-Tags, und der Server wählt die beste verfügbare Übersetzung für die angeforderte Ressource aus.

Browser füllen diesen Header anhand der Spracheinstellungen des Betriebssystems. Der Wert folgt der BCP-47-Syntax für Sprach-Tags und unterstützt primäre Sprachcodes (en, de, fr) sowie regionale Subtags (en-US, pt-BR, zh-CN). Qualitätswerte ordnen die Präferenzen, wenn mehrere Sprachen aufgeführt sind.

Der Server teilt die Sprache des zurückgegebenen Inhalts über den Antwort-Header Content-Language mit. Existiert keine passende Übersetzung, geben die meisten Server die Standardsprache zurück, statt mit 406 Not Acceptable zu antworten, da das Ausliefern von Inhalten in einer Rückfallsprache in der Regel nützlicher ist als eine Fehlermeldung.

language-tag

Ein BCP-47-Sprach-Tag. Ein primäres Subtag wie en passt auf jede regionale Variante. Ein Tag mit Regions-Subtag wie en-GB zielt auf eine bestimmte Locale.

*

Ein Platzhalter, der auf jede noch nicht aufgeführte Sprache passt.

;q= (Qualitätswert)

Ein Gewicht zwischen 0 und 1, das die relative Präferenz ausdrückt. Der Standardwert ist 1.0. Ein Wert von 0 kennzeichnet eine Sprache als nicht akzeptabel.

Beispiel

Ein Client bevorzugt britisches Englisch, mit allgemeinem Englisch als Rückfallebene und Deutsch mit verringerter Priorität. Der Server antwortet mit Inhalten in allgemeinem Englisch.

Anfrage

GET / HTTP/1.1
Host: example.com
Accept-Language: en-GB, en;q=0.9, de;q=0.5

Antwort

HTTP/1.1 200 OK
Content-Language: en

Eine Anfrage von einem Browser, der auf Französisch eingestellt ist, mit Rückfall auf eine beliebige Sprache.

Accept-Language: fr-FR, fr;q=0.9, *;q=0.5

Eine mehrsprachige Präferenzliste, die Spanisch an erste, Portugiesisch an zweite und Englisch an dritte Stelle setzt.

Accept-Language: es, pt;q=0.8, en;q=0.6