Definition  

Der HTTP 201 Created-Statuscode signalisiert, dass eine Anfrage erfolgreich war und zur Erstellung einer neuen Ressource geführt hat. Diese neue Ressource wird erstellt, bevor die Antwort zurückgesendet wird, und die Details der neu erstellten Ressource werden im Nachrichtentext übermittelt.

Erklärung  

Der 201 Created-Statuscode bestätigt, dass der Server eine neue Ressource erfolgreich erstellt hat. Diese Ressource kann entweder unter der URL der ursprünglichen Anfrage oder unter der im Location-Header angegebenen URL gefunden werden. Dieser Statuscode wird typischerweise als Antwort auf eine POST-Anfrage verwendet, um anzuzeigen, dass ein neuer Eintrag erfolgreich erstellt wurde. In bestimmten Fällen kann er auch bei PUT-Anfragen verwendet werden, wenn eine Ressource an einem spezifischen Ort erfolgreich angelegt wurde.

Struktur und Aufbau  

Einige wichtige Aspekte des HTTP 201 Created-Statuscodes umfassen:

• Location Header: Wenn die neue Ressource an einem anderen Ort als der ursprünglichen Anfrage-URL erstellt wurde, enthält die Antwort den Location-Header mit der URL der neuen Ressource. Dies ermöglicht es dem Client, direkt auf die neu erstellte Ressource zuzugreifen.

• Anwendungsfälle: Der 201 Created-Statuscode wird häufig in Webanwendungen verwendet, wenn über eine API neue Benutzerkonten, Datensätze oder andere Objekte erstellt werden. Er gibt dem Client die Sicherheit, dass die Ressource erfolgreich angelegt wurde und wo sie gefunden werden kann.

• Idempotenz: Während POST-Anfragen nicht idempotent sind, sind PUT-Anfragen es, was bedeutet, dass wiederholte identische Anfragen denselben Zustand herbeiführen. Wenn ein PUT jedoch tatsächlich zu einer neuen Ressourcenerstellung führt, kann der Statuscode 201 verwendet werden.

Vorgehensweise beim Einsatz des 201 Created

Der HTTP 201 Created-Statuscode ist besonders nützlich, um klarzustellen, dass eine Anfrage erfolgreich zur Erstellung einer neuen Ressource geführt hat und dass diese Ressource über die angegebene URL zugänglich ist. Entwickler sollten sicherstellen, dass der Location-Header korrekt gesetzt ist, wenn die Ressource nicht an der ursprünglichen Anfrage-URL verfügbar ist. Dieser Statuscode gibt dem Client Klarheit und Zuverlässigkeit in Bezug auf die neu erstellte Ressource und ihren Zugriffspunkt.

Zusammengefasst zeigt der HTTP 201 Created-Statuscode an, dass eine Anfrage erfolgreich zur Erstellung einer neuen Ressource geführt hat und diese Ressource nun über die spezifizierte URL erreichbar ist.