201 Created
Der HTTP-Statuscode 201 Created
Erfolgsantwort zeigt an, dass die HTTP-Anfrage zur Erstellung einer Ressource geführt hat. Dieser Statuscode wird häufig als Ergebnis einer POST
-Anfrage gesendet.
Die neue Ressource, oder eine Beschreibung und der Link zur neuen Ressource, wird erstellt, bevor die Antwort zurückgegeben wird. Die neu erstellten Elemente werden im Körper der Nachricht zurückgegeben, entweder unter der URL der ursprünglichen Anfrage oder der URL im Wert des Location
Headers in der Antwort.
Status
201 Created
Beispiele
Erhalten einer Antwort, die die Erstellung eines Benutzers anzeigt
Angenommen, es gibt eine REST-API zur Verwaltung von Benutzern mit einem Endpunkt bei http://example.com/users
. In diesem Beispiel senden wir eine POST
-Anfrage mit folgendem Inhalt, um einen Benutzer zu erstellen:
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
{
"firstName": "Brian",
"lastName": "Smith",
"email": "brian.smith@example.com"
}
Nach erfolgreicher Erstellung des Benutzers sieht die 201 Created
-Antwort so aus:
HTTP/1.1 201 Created
Content-Type: application/json
Location: http://example.com/users/123
{
"message": "New user created",
"user": {
"id": 123,
"firstName": "Brian",
"lastName": "Smith",
"email": "brian.smith@example.com"
}
}
Spezifikationen
Specification |
---|
HTTP Semantics # status.201 |