Serverantwort 201 Created

Was bedeutet der Statuscode 201?

Der HTTP-Statuscode 201 (Created) zeigt an, dass ein neuer Ressource erfolgreich erstellt wurde. Dieser Code wird häufig verwendet, wenn eine Operation auf dem Server durchgeführt wird, die zur Erstellung eines neuen Objekts führt. Die Rückgabe dieses Codes signalisiert, dass die Anfrage erfolgreich war und der neue Ressource jetzt verfügbar ist.

Kontext der Anwendung in APIs

In der Welt der APIs wird der Statuscode 201 oft verwendet, um anzuzeigen, dass eine Anfrage, die eine Ressource erstellt, erfolgreich war. Dies kann in verschiedenen Szenarien auftreten, wie zum Beispiel beim Erstellen eines neuen Benutzers, eines Blogbeitrags oder eines Produktes in einem Online-Shop.

Praktische Beispiele für die Verwendung des Codes 201

Beispiel für die erfolgreiche Erstellung eines Benutzers: Wenn ein neuer Benutzer sich registriert, sendet die API eine POST-Anfrage, und bei Erfolg wird der Statuscode 201 zurückgegeben.
Beispiel für die Erstellung eines neuen Blogbeitrags: Bei der Veröffentlichung eines neuen Beitrags wird ebenfalls eine POST-Anfrage verwendet, die den Status 201 zurückgibt, wenn der Beitrag erfolgreich gespeichert wurde.
Beispiel für das Hinzufügen eines Produkts in einem Online-Shop: Wenn ein neues Produkt in das System eingefügt wird, wird der Statuscode 201 zurückgegeben, um zu bestätigen, dass das Produkt erfolgreich erstellt wurde.

Fehlercode 201: Wann kann er auftreten und wie geht man damit um?

Der Statuscode 201 selbst ist kein Fehlercode, sondern ein erfolgreicher Rückgabewert. Dennoch können Fehler während des Erstellungsprozesses auftreten, die zu einem anderen HTTP-Statuscode führen, wie z.B. 400 (Bad Request) oder 500 (Internal Server Error).

Ursachen für Fehler bei der Erstellung einer Ressource:
- Unzureichende Daten in der Anfrage
- Fehlerhafte API-URL
- Probleme mit der Serverkonfiguration
Wie man die Antwort mit dem Statuscode 201 richtig behandelt:
- Überprüfen, ob die Rückgabe den erwarteten Daten entspricht
- Die ID oder den Standort der neu erstellten Ressource speichern

Behebung von Problemen beim Erstellen von Ressourcen in verschiedenen Programmiersprachen

Beispiel in Python (Verwendung der Bibliothek requests)
- Schritte zum Senden der Anfrage und zur Verarbeitung der Antwort:
- Importieren der Bibliothek.
- Erstellen der Daten für die Anfrage.
- Senden der POST-Anfrage und Überprüfen des Statuscodes.
Beispiel in JavaScript (Verwendung der Fetch API)
- Wie man eine POST-Anfrage sendet und die Antwort vom Server verarbeitet:
- Verwenden der fetch-Funktion mit der Methode POST.
- Überprüfen der Rückgabe des Statuscodes 201.
Beispiel in PHP (Verwendung von cURL)
- Wie man eine Anfrage zur Erstellung einer Ressource sendet und den Status der Antwort verarbeitet:
- Initialisieren von cURL.
- Senden der Anfrage und Überprüfen des Rückgabestatus.

Verarbeitung der erfolgreichen Antwort mit dem Statuscode 201

Bei Erhalt des Statuscodes 201 sollte man die zurückgegebenen Daten sorgfältig interpretieren. Oft enthält die Antwort Informationen über die neu erstellte Ressource, wie z.B. die ID oder den URI, unter dem sie verfügbar ist. Diese Daten können verwendet werden, um weitere Aktionen durchzuführen, wie das Abrufen, Aktualisieren oder Löschen der Ressource.

Empfehlungen für die Arbeit mit dem Statuscode 201

Beste Praktiken bei der Arbeit mit APIs:
- Immer die Dokumentation der API konsultieren, um die richtigen Endpunkte und Datenformate zu verstehen.
- Fehler richtig behandeln und informative Rückmeldungen an den Benutzer geben.
Wie man die Erstellung von Ressourcen testet und die Korrektheit der Antworten überprüft:
- Automatisierte Tests entwickeln, um sicherzustellen, dass die API die erwarteten Statuscodes zurückgibt.
- Verwendung von Tools wie Postman zur manuellen Überprüfung der API-Funktionalität.

Aktion	Statuscode	Bedeutung
Erstellen eines Benutzers	201	Benutzer erfolgreich erstellt
Erstellen eines Blogbeitrags	201	Blogbeitrag erfolgreich erstellt
Hinzufügen eines Produkts	201	Produkt erfolgreich hinzugefügt