Der HTTP-Statuscode201 Createderfolgreiche Antwort zeigt an, dass die HTTP-Anfrage zur Erstellung einer Ressource geführt hat. Dieser Statuscode wird häufig als Ergebnis einerPOST-Anfrage gesendet.

Die neue Ressource oder eine Beschreibung und ein Link zur neuen Ressource wird erstellt, bevor die Antwort zurückgegeben wird. Die neu erstellten Elemente können im Body der Antwortnachricht zurückgegeben werden, müssen jedoch durch dieURL der auslösenden Anfrage oder durch die URL im Wert des mit der Antwort bereitgestelltenLocation-Headers auffindbar sein.

Status

201 Created

Beispiele

Empfang einer Antwort, die die Benutzererstellung angibt

Nehmen wir an, es gibt eine REST-API zur Verwaltung von Benutzern mit einem Endpunkt unterhttp://example.com/users. In diesem Beispiel senden wir einePOST-Anfrage mit folgendem Body, um einen Benutzer zu erstellen:

POST /users HTTP/1.1Host: example.comContent-Type: application/json{  "firstName": "Brian",  "lastName": "Smith",  "email": "brian.smith@example.com"}

Nach erfolgreicher Benutzererstellung sieht die201 Created-Antwort wie folgt aus:

HTTP/1.1 201 CreatedContent-Type: application/jsonLocation: http://example.com/users/123{  "message": "New user created",  "user": {    "id": 123,    "firstName": "Brian",    "lastName": "Smith",    "email": "brian.smith@example.com"  }}

Spezifikationen

Siehe auch

• HTTP-Anfragemethoden
• HTTP-Antwortstatuscodes