POST

Die POST HTTP-Methode sendet Daten an den Server. Der Typ des Anfragetexts wird durch den Content-Type Header angegeben.

Der Unterschied zwischen PUT und POST besteht darin, dass PUT idempotent ist: ein Aufruf ist nicht anders als mehrere aufeinanderfolgende Aufrufe (es gibt keine Nebeneffekte). Aufeinanderfolgende identische POST-Anfragen können zusätzliche Effekte haben, wie z. B. das mehrfache Erstellen derselben Bestellung.

HTML-Formulare senden Daten typischerweise mit POST, was normalerweise eine Änderung auf dem Server zur Folge hat. Für HTML-Formulare wird das Format/die Kodierung des Inhalts des Anfragetexts durch das enctype Attribut des <form> Elements oder das formenctype Attribut der <input> oder <button> Elemente bestimmt. Die Kodierung kann eine der folgenden sein:

• application/x-www-form-urlencoded: die Schlüssel und Werte werden in Schlüssel-Wert-Tupeln kodiert, die durch ein kaufmännisches Und-Zeichen (&) getrennt sind, mit einem Gleichheitszeichen (=) zwischen dem Schlüssel und dem Wert (z. B. first-name=Frida&last-name=Kahlo). Nicht-alphanumerische Zeichen in sowohl Schlüsseln als auch Werten werden prozentkodiert: Aus diesem Grund ist dieser Typ nicht geeignet für die Verwendung mit Binärdaten, und Sie sollten stattdessen multipart/form-data für diesen Zweck verwenden.
• multipart/form-data: jeder Wert wird als Datenblock ("Body-Part") gesendet, wobei ein von der Benutzerumgebung definierter Trenner (zum Beispiel boundary="delimiter12345") jeden Teil trennt. Die Schlüssel werden im Content-Disposition Header jedes Teils oder Blocks von Daten beschrieben.
• text/plain

Wenn die POST-Anfrage infolge eines fetch() Aufrufs gesendet wird oder aus einem anderen Grund als einem HTML-Formular, kann der Anfragetext jeden Typ haben. Wie in der HTTP 1.1-Spezifikation beschrieben, ist POST dazu gedacht, eine einheitliche Methode für die folgenden Funktionen bereitzustellen:

• Kommentierung vorhandener Ressourcen
• Posten einer Nachricht auf einem schwarzen Brett, in einer Newsgroup, Mailingliste oder einer ähnlichen Artikelgruppe
• Hinzufügen eines neuen Benutzers über ein Anmeldeformular
• Bereitstellung eines Datenblocks, wie das Ergebnis eines Formular-Abschlusses, für einen Datenverarbeitungsprozess
• Erweiterung einer Datenbank durch eine Anfügeoperation

Anfrage hat einen Body	Ja
Erfolgreiche Antwort hat einen Body	Ja
Sicher	Nein
Idempotent	Nein
Cache-fähig	Nur wenn Informationen zur Frische enthalten sind
Erlaubt in HTML-Formularen	Ja

POST <request-target>["?"<query>] HTTP/1.1

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

field1=value1&field2=value2

POST /test HTTP/1.1
Host: example.com
Content-Type: multipart/form-data;boundary="delimiter12345"

--delimiter12345
Content-Disposition: form-data; name="field1"

value1
--delimiter12345
Content-Disposition: form-data; name="field2"; filename="example.txt"

value2
--delimiter12345--