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

http
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:

http
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
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

Siehe auch