HTTP 201 Created

Durch diese Anfrage wird eine neue Ressource erzeugt. Eine korrekt konfigurierte API sendet außerdem einen Location-Header, der auf diese Ressource verweist, und üblicherweise die erzeugte Repräsentation als Anfragetext.

Definiert in RFC 9110 §15.3.2 — 201 Created · MDN-Referenz

Wo Ihnen HTTP 201 in der Praxis begegnet

Anmeldungen, Bestellungen, Uploads, Buchungen, Kommentare – alles, wo ein POST-Vorgang etwas hinterlässt, das anschließend eine eigene Adresse hat und wo der Aufrufer es sehr wahrscheinlich einen Moment später abrufen oder ändern möchte.

Warum Sie ihn testen sollten

Prüfen Sie den Location-Header, nicht nur den Status – Clients, die die Folge-URL selbst erstellen, funktionieren nicht mehr, sobald der Server sein ID-Schema ändert.

Was Ihr Client bei einem 201 tun sollte

Lesen Sie den Location-Header und folgen Sie ihm, statt die URL selbst aus der ID im Body zusammenzubauen. Server ändern ihre ID-Schemata; Clients, die raten, brechen an dem Tag, an dem das passiert. Enthält der Body die angelegte Repräsentation, verwenden Sie sie statt eines sofortigen erneuten Abrufs.

201 und die Codes, mit denen er verwechselt wird

Endpunkte, die 201 zurückgeben

59 Endpunkte dieses Playgrounds antworten mit 201. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

…und 34 weitere Endpunkte im Katalog.

Fragen zu HTTP 201

Muss ein 201 einen Aufbau beinhalten?
Nein. Der Location-Header ist das Wichtige; der Body ist eine Annehmlichkeit, die dem Client einen Roundtrip spart.
Was wäre, wenn die Ressource bereits existierte?
Dann wurde sie nicht angelegt. 200 mit der vorhandenen Repräsentation, oder 409, wenn die Anfrage eindeutig ein Duplikat anlegen wollte.

Weitere Erfolgscodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert