Content-Type header

Syntax

Content-Type: <media-type>

Zum Beispiel:

Content-Type: text/html; charset=utf-8
Content-Type: multipart/form-data; boundary=ExampleBoundaryString

Direktiven

<media-type>

Der Medientyp der Ressource oder Daten. Kann die folgenden Parameter enthalten:

• charset: Gibt den Zeichenkodierung Standard an. Der Wert ist nicht case-sensitiv, jedoch wird Kleinschreibung bevorzugt.
• boundary: Für mehrteilige Entitäten ist der boundary Parameter erforderlich. Er wird verwendet, um die Grenzen der verschiedenen Teile der Nachricht zu markieren. Der Wert besteht aus 1 bis 70 Zeichen (nicht mit Leerzeichen endend), die in verschiedenen Systemumgebungen robust sind (z.B. E-Mail-Gateways). Oft wird der Header-Grenzwert im Anfragekörper mit zwei Bindestrichen vorangestellt, und die endgültige Grenze hat am Ende zwei Bindestriche angefügt.

Beispiele

Ausliefern von Assets mit dem korrekten Content-Type

In den folgenden zwei Beispielantworten werden JavaScript- und CSS-Assets unter Verwendung von text/javascript für JavaScript und text/css für CSS ausgeliefert. Der korrekte Content-Type für diese Ressourcen hilft dem Browser, sie sicherer und mit besserer Leistung zu verarbeiten. Siehe Server-MIME-Typen korrekt konfigurieren für weitere Informationen.

HTTP/1.1 200
content-encoding: br
content-type: text/javascript; charset=utf-8
vary: Accept-Encoding
date: Fri, 21 Jun 2024 14:02:25 GMT
content-length: 2978

const videoPlayer=document.getElementById...

HTTP/3 200
server: nginx
date: Wed, 24 Jul 2024 16:53:02 GMT
content-type: text/css
vary: Accept-Encoding
content-encoding: br

.super-container{clear:both;max-width:100%}...

Content-Type in mehrteiligen Formularen

In einer POST-Anfrage, die aus einer HTML-Formularübermittlung resultiert, wird der Content-Type der Anfrage durch das enctype Attribut auf dem <form> Element angegeben.

<form action="/foo" method="post" enctype="multipart/form-data">
  <input type="text" name="description" value="Description input value" />
  <input type="file" name="myFile" />
  <button type="submit">Submit</button>
</form>

Die Anfrage sieht ungefähr wie das folgende Beispiel aus, wobei einige Header zur Kürze weggelassen wurden. In der Anfrage wird eine Grenze von ExampleBoundaryString zu Illustrationszwecken verwendet, aber in der Praxis würde ein Browser eine Zeichenfolge erzeugen, die eher so aussieht: ---------------------------1003363413119651595289485765.

POST /foo HTTP/1.1
Content-Length: 68137
Content-Type: multipart/form-data; boundary=ExampleBoundaryString

--ExampleBoundaryString
Content-Disposition: form-data; name="description"

Description input value
--ExampleBoundaryString
Content-Disposition: form-data; name="myFile"; filename="foo.txt"
Content-Type: text/plain

[content of the file foo.txt chosen by the user]
--ExampleBoundaryString--

Content-Type in einer URL-codierten Formularübermittlung

Wenn Formulare keine Datei-Uploads beinhalten und einfachere Felder verwenden, können URL-codierte Formulare bequemer sein, bei denen die Formulardaten im Anforderungskörper enthalten sind:

<form action="/submit" method="post">
  <label for="comment">Comment:</label>
  <input type="text" id="comment" name="comment" value="Hello!" />
  <button type="submit">Submit</button>
</form>

POST /submit HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 16

comment=Hello%21

Content-Type in einer REST-API mit JSON

Viele REST APIs verwenden application/json als Content-Type, was für die Kommunikation von Maschine zu Maschine oder programmatische Interaktion bequem ist. Das folgende Beispiel zeigt eine 201 Created Antwort, die das Ergebnis einer erfolgreichen Anfrage darstellt:

HTTP/1.1 201 Created
Content-Type: application/json

{
  "message": "New user created",
  "user": {
    "id": 123,
    "firstName": "Paul",
    "lastName": "Klee",
    "email": "p.klee@example.com"
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Accept, Accept-Encoding, Accept-Language Header
• Vary
• Content-Encoding
• Content-Disposition
• 206 Partial Content
• X-Content-Type-Options