POST

Die POST HTTP-Methode sendet Daten an den Server. Der Typ des Anfragekörpers wird durch den Content-Type Header angezeigt.

Der Unterschied zwischen PUT und POST besteht darin, dass PUT idempotent ist: Ein einmaliger Aufruf unterscheidet sich nicht von mehrmaligen aufeinanderfolgenden Aufrufen (es gibt keine Nebeneffekte). Aufeinanderfolgende identische POST-Anfragen können zusätzliche Effekte haben, wie z. B. das mehrmalige Erstellen derselben Bestellung.

HTML-Formulare senden Daten typischerweise mit POST und dies führt normalerweise zu einer Änderung auf dem Server. Für HTML-Formulare wird das Format/die Kodierung des Inhalts des Körpers 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-Tupel enkodiert, die durch ein Und-Zeichen (&) getrennt sind, mit einem Gleichheitszeichen (=) zwischen Schlüssel und Wert (z.B. first-name=Frida&last-name=Kahlo). Nicht alphanumerische Zeichen in sowohl Schlüsseln als auch Werten sind percent-kodiert: dies ist der Grund, warum dieser Typ nicht geeignet ist für die Verwendung mit binären Daten, und Sie stattdessen multipart/form-data für diesen Zweck verwenden sollten.
• multipart/form-data: Jeder Wert wird als ein Datenblock ("body part") gesendet, mit einem durch den User-Agent definierten Trennzeichen (zum Beispiel boundary="delimiter12345") das jeden Teil trennt. Die Schlüssel werden im Content-Disposition Header jedes Teils oder Blocks von Daten beschrieben.
• text/plain

Wenn die POST-Anfrage nach einem fetch() Aufruf gesendet wird, oder aus einem anderen Grund als einem HTML-Formular, kann der Körper beliebiger Typ sein. Wie im HTTP 1.1 Standard beschrieben, ist POST so konzipiert, dass es eine einheitliche Methode bietet, um die folgenden Funktionen abzudecken:

• Annotation vorhandener Ressourcen
• Posten einer Nachricht auf einem Schwarzen Brett, in einer Newsgroup, Mailingliste oder ähnlichen Gruppen von Artikeln
• Hinzufügen eines neuen Benutzers über ein Anmeldeformular
• Bereitstellung eines Datenblocks, wie das Ergebnis des Sendens eines Formulars, zu einem Datenverarbeitungsprozess
• Erweiterung einer Datenbank durch einen Anhangsvorgang

Anfrage hat einen Körper	Ja
Erfolgreiche Antwort hat einen Körper	Ja
Sicher	Nein
Idempotent	Nein
Cacheable	Nur wenn Aktualitätsinformationen 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--