# Content Negotiation

Unter Content Negotiation (Inhaltsvereinbarung) versteht man eine Technik im Hypertext Transfer Protocol, die eine Abstimmung der Inhalte der angefragten Ressource aufgrund der Möglichkeiten und Vorzüge des Clients ermöglicht.

## Funktionsweise

Im HTTP stehen zur Inhaltsvereinbarung die Anfrage-Header-Felder Accept, Accept-Charset, Accept-Encoding sowie Accept-Language zur Verfügung, die eine durch Kommas getrennte Liste bewerteter Eigenschaften beschreiben.

### Accept

    Liste akzeptierter Inhaltstypen. Gegenstück in der Antwort ist das Content-Type-Feld

### Accept-Charset

    Liste akzeptierter Zeichensätze beziehungsweise Zeichenkodierungen. Gegenstück in der Antwort ist der charset-Parameter des Content-Type-Felds

### Accept-Encoding

    Liste akzeptierter Kodierungen. Gegenstück in der Antwort ist das Content-Encoding-Feld

### Accept-Language

    Liste akzeptierter Sprachen. Gegenstück in der Antwort ist das Content-Language-Feld
Die Bewertung der Eigenschaften ist über den optionalen Qualitätsparameter q möglich, der Werte zwischen 0 (inakzeptabel) und 1 (bevorzugt) erlaubt; fehlt dieser, wird der Standardwert 1 angenommen. Bei gleicher Wertigkeit wird je nach Header-Feld zusätzliche die Spezifität der Eigenschaft bei der Bestimmung der Reihenfolge herangezogen, wobei spezifischere den weniger spezifischen Eigenschaften vorgezogen werden.
Zusätzlich sollte bei der Nutzung von HTTP-Caching-Techniken in der Antwort des Webservers das Vary-Header-Feld diejenigen Header-Felder der Anfrage genannt werden, die bei der Abstimmung berücksichtigt wurden, die also zur eindeutigen Auswahl der gesendeten Repräsentation der Ressource führten.
Falls die angeforderte URL eine generische ist, sie also die Repräsentation der Ressource nicht eindeutig beschreibt und stattdessen eine Inhaltsvereinbarung stattfindet, die ausgelieferte Repräsentation jedoch eine eigene spezifische URL besitzt, kann diese im Content-Location-Header-Feld angegeben werden.

## Beispiel

Eine der am weitesten verbreiteten Anwendungen ist die automatische Auswahl der Sprache (englisch Language Negotiation). Dazu sendet der Client in seiner Anfrage das Feld Accept-Language:
Diese Angabe ist so zu interpretieren, dass der Client Deutsch, Englisch und Französisch akzeptiert, wobei allerdings bundesdeutsches Hochdeutsch vor allen anderen Deutsch-Varianten sowie vor Englisch und Französisch bevorzugt wird. Wenn der Server also über eine Version im bundesdeutschen Hochdeutsch, im österreichischen Deutsch und im Schweizer Hochdeutsch verfügt, sollte die bundesdeutsche Version ausgeliefert werden.
Eine Antwort des Webservers könnte dann beispielsweise wie folgt aussehen, hier wird deutschsprachiger Content geladen, ohne eine Varietät des Standarddeutschen zu spezifizieren:

## HTTP-Statuscodes

Das HTTP bietet spezielle Statuscodes an, die der Server an den Client senden sollte, wenn eine inhaltliche Abstimmung nicht möglich war:

### 300 Multiple Choices

    Wird gesendet, wenn mehrere zu den in der Anfrage gestellten Bedingungen passenden Ressourcen an anderer Stelle zu finden sind oder der Server dem Client die Auswahl überlassen möchte. Die entsprechenden Adressen und Charakteristiken der Auswahlmöglichkeiten sollten im Dokument angegeben werden; der Server kann die Adresse eines von ihm bevorzugten Dokuments im Location-Header-Feld mitsenden.

### 406 Not Acceptable

    Wird gesendet, wenn die angefragte Ressource zwar existiert, die vom Client gesendeten Bedingungen aber nicht erfüllbar sind.

### 506 Variant Also Negotiates

    Die Inhaltsvereinbarung der Anfrage ergibt einen Zirkelbezug.

## Unterstützung durch Webserver

Der Apache HTTP Server bietet über das Modul mod_negotiation die Möglichkeit mehrere Sprachen anzubieten, ohne viel aufwendige Konfiguration betreiben zu müssen. Dazu muss (in der Standardeinstellung) lediglich die ISO-639-Kennung der jeweiligen Sprache an den Dateinamen angehängt werden, so wird deutschen Browsern, die die Datei foo.html anfordern, eigentlich die Datei foo.html.de ausgeliefert. Hierzu erzeugt mod_negotiation transparent typemaps.