300 Multiple Choices
Der HTTP 300 Multiple Choices redirection response Statuscode zeigt an, dass die Anfrage mehr als eine mögliche Antwort hat.
Der Benutzer-Agent oder der Benutzer sollte eine davon wählen.
Hinweis: Bei der agent-engesteuerten Inhaltsaushandlung entscheiden ein Client und ein Server gemeinsam die beste Variante einer gegebenen Ressource, wenn der Server mehrere Varianten besitzt.
Die meisten Clients haben keine Methode, um automatisch zwischen Antworten zu wählen, und die zusätzlichen Round-Trips verlangsamen die Interaktion zwischen Client und Server.
Server-gesteuerte Inhaltsaushandlung ist weitaus häufiger, wobei ein Server die geeignetste Ressource für den Client basierend auf den Anfrage-Headern auswählt (Accept-Language, Accept, etc.).
Der Server sollte Inhalte in die Antwort aufnehmen, die eine Liste von Ressourcendaten und URIs enthalten, aus denen der Benutzer oder Benutzer-Agent wählen kann. Das Format der Inhalte ist implementationsspezifisch, sollte aber vom Benutzer-Agenten leicht geparst werden können (wie HTML oder JSON).
Wenn der Server eine bevorzugte Wahl hat, die der Client anfordern sollte, kann er diese in einem Location-Header angeben.
Status
300 Multiple Choices
Beispiele
300-Antwort mit Liste von Ressourcen
Das folgende Beispiel zeigt einen Transparenten Inhaltsaushandlungs-Request-Response-Austausch.
Ein Apache-Server bietet mehrere Varianten einer Ressource an, die in einer typen Karte definiert sind; index.html.en für eine Ressource in Englisch und index.html.fr für eine französische Version:
URI: index.html.en Content-Language: en URI: index.html.fr Content-Language: fr
Ein Negotiate: trans Anfrage-Header zeigt an, dass der Client TCN verwenden möchte, um eine Ressource auszuwählen.
Schlechte Browserunterstützung für diesen Mechanismus bedeutet, dass ein Benutzer-Agent wie curl stattdessen verwendet werden muss:
curl -v -H "Negotiate: trans" http://localhost/index
Dies erzeugt die folgende Anfrage:
GET /index HTTP/1.1
Host: localhost
User-Agent: curl/8.7.1
Accept: */*
Negotiate: trans
Wir erhalten eine 300-Antwort mit Details zu verschiedenen Darstellungen der angeforderten Ressource:
HTTP/1.1 300 Multiple Choices
Date: Fri, 30 Aug 2024 09:21:48 GMT
Server: Apache/2.4.59 (Unix)
Alternates: {"index.html.en" 1 {type text/html} {language en} {length 48}}, {"index.html.fr" 1 {type text/html} {language fr} {length 45}}
Vary: negotiate,accept-language
TCN: list
Content-Length: 419
Content-Type: text/html; charset=iso-8859-1
<html><head>
<title>300 Multiple Choices</title>
</head><body>
<h1>Multiple Choices</h1>
Available variants:
<ul>
<li><a href="index.html.en">index.html.en</a> , type text/html, language en</li>
<li><a href="index.html.fr">index.html.fr</a> , type text/html, language fr</li>
</ul>
</body></html>
Spezifikationen
| Specification |
|---|
| HTTP Semantics # status.300 |