In diesem Artikel erläutern wir die beliebtesten HTTP-Anfragemethoden für REST API, zeigen die Unterschiede zwischen den Methoden POST, GET, PUT, DELETE und PATCH und erklären, wie Sie sie alle einsetzen können!
Was ist eine HTTP-Anfrage?
Wenn eine API die Art ist, wie Anwendungen miteinander kommunizieren, dann sind HTTP-Anfragen die Sätze. Und genau wie Sätze können wir sie je nach Ziel der Aussage in Gruppen einteilen: Möchten wir etwas abfragen oder eine Nachricht übermitteln?
In der REST API werden HTTP-Anfragen daher je nach Zweck in Methoden unterteilt.
Hier sind die gebräuchlichsten Methoden:
- GET
- POST
- PUT
- DELETE
- PATCH
Sehen wir uns diese Methoden Schritt für Schritt an!
Erstellen Sie unbegrenzt viele Integrationen mit Verzweigungen und mehreren Triggern, die in einem Node zusammenlaufen. Nutzen Sie Low-Code oder schreiben Sie eigenen Code mit AI Copilot.
GET-Methode
HTTP-GET-Anfragen verstehen
HTTP-GET-Anfragen dienen dazu, Informationen aus einer bestimmten Ressource im Internet abzurufen, ohne die Daten zu verändern. Diese Methode ist sicher, weil sie den Zustand der Daten nicht ändert. Dieses Konzept ist entscheidend, um GET-Anfragen von anderen HTTP-Anfragetypen wie POST oder PUT zu unterscheiden, die zum Ändern oder Hinzufügen von Daten auf dem Server verwendet werden.
GET-Anfragen sollten bei mehrfacher Ausführung stets dieselben Ergebnisse liefern, sofern die Daten nicht durch eine POST- oder PUT-Anfrage aktualisiert wurden. Diese Eigenschaft ist grundlegend, um den Unterschied zwischen GET- und POST-Anfragen sowie die Rolle von PUT-Anfragen in der Webentwicklung zu verstehen.
Antwortcodes für GET-Anfragen
Wenn eine GET-Anfrage gestellt wird, antwortet der Server je nach Ergebnis mit unterschiedlichen Statuscodes:
- Ein Statuscode 200 (OK) bedeutet, dass die Anfrage erfolgreich war und der Server die angeforderten Informationen zurückgibt – ein direktes Beispiel für eine erfolgreiche GET-Anfrage.
- Ein Statuscode 404 (NOT FOUND) zeigt an, dass die angeforderte Ressource auf dem Server nicht gefunden werden kann – ein wichtiges mögliches Ergebnis einer GET-Anfrage.
- Ein Statuscode 400 (BAD REQUEST) wird zurückgegeben, wenn die Anfrage fehlerhaft formatiert war. Das verdeutlicht, wie wichtig eine korrekte Strukturierung von HTTP-Anfragen ist.
Diese Antworten sind für Entwickler entscheidend, um zu verstehen, wie ihre Anfragen verarbeitet werden. Sie gehören zum grundlegenden Wissen über HTTP-Methoden, einschließlich GET, POST und PUT.
Praktische Beispiele für GET-Anfragen
Sehen wir uns einige praktische Beispiele an, um zu verstehen, wie GET-Anfragen eingesetzt werden:
- Abrufen einer Liste von Benutzerkonten: HTTP GET http://www.exampledomain.com/accounts
- Abrufen einer Teilmenge von Benutzerkonten mit bestimmten Parametern: HTTP GET http://www.exampledomain.com/accounts?limit=20&offset=5
- Aufrufen von Details zu einem bestimmten Benutzerkonto: HTTP GET http://www.exampledomain.com/accounts/123
- Abrufen detaillierter Informationen zur Adresse eines Benutzers: HTTP GET http://www.exampledomain.com/accounts/123/details
POST-Methode
HTTP-POST-Anfragen sind in der Webentwicklung wichtig, um neue untergeordnete Ressourcen zu erstellen, beispielsweise eine Datei zu einem Verzeichnis oder eine neue Zeile zu einer Datenbanktabelle hinzuzufügen. Diese Methode ist besonders relevant, wenn es darum geht, was eine POST-Anfrage ist und wie Sie eine POST-Anfrage senden.
Im Kontext von RESTful Services wird POST hauptsächlich verwendet, um einer Sammlung von Ressourcen eine neue Entität hinzuzufügen. Dieser Prozess ist zentral für das Verständnis des Unterschieds zwischen GET und POST sowie der Interaktionen von GET, POST und PUT.
Beachten Sie, dass Antworten auf POST-Methoden nicht zwischenspeicherbar sind, sofern dies nicht durch die Header-Felder Cache-Control oder Expires angegeben wird. Dadurch unterscheidet sich POST im Hinblick auf das Cache-Verhalten von GET-Anfragen.
Im Gegensatz zu GET-Anfragen ist POST weder sicher noch idempotent. Das bedeutet, dass die wiederholte Ausführung identischer POST-Anfragen mehrere eindeutige Ressourcen erstellt. Dies verdeutlicht die praktischen Auswirkungen von POST und GET, POST und PUT sowie der gesamten Landschaft der Anfragemethoden.
Welche API-Antwortcodes gibt es für POST?
Wenn eine POST-Operation erfolgreich eine neue Ressource auf dem Server erstellt, lautet die passende Antwort der Statuscode 201 (Created). Diese Antwort sollte das Ergebnis der Anfrage beschreiben, auf die neue Ressource verweisen und einen Location-Header enthalten. Das ist ein praxisnahes Beispiel für POST-Anfragen und HTTP-POST-Antworten.
Es gibt Fälle, in denen eine POST-Aktion nicht zu einer eindeutig identifizierbaren Ressource führt. In solchen Fällen kann der Server einen Status 200 (OK) oder 204 (No Content) zurückgeben. Dies verdeutlicht die differenzierten Unterschiede zwischen POST- und PUT-Anfragen, GET und POST sowie dem gesamten Rahmen der Anfragemethoden.
POST-Anfragen anhand von Beispielen
Zur Veranschaulichung sehen Sie hier Beispiel-URIs, die den Einsatz von POST an eine URL und die POST-Methode zeigen:
- Erstellen eines neuen Benutzerprofils: HTTP POST http://www.exampledomain.com/accounts
- Hinzufügen bestimmter Details zu einem Benutzerprofil: HTTP POST http://www.exampledomain.com/accounts/123/details
PUT-Methode
Verwenden Sie PUT-APIs hauptsächlich, um eine bestehende Ressource zu aktualisieren (falls die Ressource nicht existiert, kann die API entscheiden, ob eine neue Ressource erstellt wird oder nicht).
Wenn die Anfrage einen Cache durchläuft und die Request-URI eine oder mehrere aktuell zwischengespeicherte Entitäten identifiziert, SOLLEN diese Einträge als veraltet behandelt werden. Antworten auf die PUT-Methode sind nicht zwischenspeicherbar.
3.1. Antwortcodes der PUT-API
HTTP-PUT-Anfragen sind entscheidend, um bestehende Online-Inhalte anzupassen oder neue Elemente hinzuzufügen, falls diese noch nicht existieren. Diese Methode ist besonders nützlich, wenn Sie Details auf einer Webseite aktualisieren oder neue Einträge übermitteln. Sie liegt an der Schnittstelle zwischen der Frage, was eine PUT-Anfrage ist, und der Entscheidung zwischen PUT und POST. Sie ist ein grundlegendes Werkzeug für Entwickler, insbesondere bei der Abwägung zwischen POST und PUT oder der Untersuchung der Feinheiten von PUT- und POST-Aktionen.
Wenn eine PUT-Anfrage einen Cache durchläuft und feststellt, dass sie bereits gespeicherte Inhalte adressiert, werden diese Inhalte als veraltet markiert. Interessant ist, dass die Ergebnisse dieser PUT-Aktionen nicht im Cache gespeichert werden. Das unterscheidet sie von der Behandlung von GET- und POST-Anfragen. Diese Unterscheidung ist entscheidend für den Unterschied zwischen GET und POST sowie für das Verständnis des strategischen Einsatzes von GET, POST und PUT in der Webentwicklung.
Wichtige Punkte zu PUT-Antworten
- Wenn PUT etwas Neues erstellt, informiert Sie der Webserver mit einer Meldung 201 (Created). Dies schafft Klarheit darüber, wann eine HTTP-POST-Antwort erfolgt und wann POST an eine URL verwendet wird.
- Wenn etwas Bestehendes geändert wird, erhalten Sie eine Bestätigung mit 200 (OK) oder einen einfachen Hinweis 204 (No Content). Das ist eine kompakte Möglichkeit, zwischen PUT-Methoden und der Diskussion über PUT und POST zu unterscheiden.
Beispiele für PUT in der Praxis
Sehen wir uns PUT in Aktion an:
- Um Benutzerinformationen zu aktualisieren, verwenden Sie: HTTP PUT http://www.exampledomain.com/accounts/123
- Kontodetails ändern? Verwenden Sie: HTTP PUT http://www.exampledomain.com/accounts/123/details
DELETE-Methode
So funktioniert DELETE mit Web-APIs
Die DELETE-Funktion in Web-APIs ist unkompliziert: Sie entfernt Ressourcen, die Sie über ihre Webadressen (URIs) angeben.
Interessant an DELETE ist: Die Methode soll jedes Mal gleich funktionieren. Wenn Sie etwas löschen, sollte es gelöscht bleiben. Manche argumentieren jedoch, dass ein Element nach dem Löschen nicht mehr vorhanden ist und ein erneuter Löschversuch somit nicht wirklich dieselbe Aktion ausführt. Das kann Zweifel daran aufwerfen, ob DELETE immer gleich funktioniert. Darüber wird unterschiedlich diskutiert.
Wenn Ihre DELETE-Anfrage einen Ort durchläuft, an dem Webinformationen gespeichert werden, etwa einen Cache, und dort Inhalte unter derselben Adresse findet, sollten diese Inhalte als veraltet markiert werden. Außerdem werden die Antworten auf eine DELETE-Anfrage nicht in diesem Cache gespeichert.
Was passiert nach DELETE?
Was nach dem Ausführen von DELETE geschieht, kann variieren:
- Sie erhalten möglicherweise einen Status 200 (OK), wenn der Server Ihnen mitteilt, wie der Löschvorgang verlaufen ist.
- Wenn der Server die Anfrage noch verarbeitet und Ihre Löschanfrage in der Warteschlange steht, sehen Sie den Status 202 (Accepted).
- Manchmal hat der Server Ihre Anfrage ausgeführt, gibt jedoch keine Details zurück. In diesem Fall sehen Sie den Status 204 (No Content).
Wenn Sie versuchen, dasselbe Element zweimal zu löschen, führt der zweite Versuch nicht zu einer neuen Änderung, da das Element bereits beim ersten Mal gelöscht wurde. Daher erhalten Sie wahrscheinlich 404 (NOT FOUND), weil aus Sicht des Servers nichts mehr vorhanden ist, das gelöscht werden könnte.
Beispiel-URIs mit aktualisierten Links
- So löschen Sie ein Benutzerprofil: HTTP DELETE http://www.exampledomain.com/accounts/123
- So entfernen Sie bestimmte Kontodetails eines Benutzers: HTTP DELETE http://www.exampledomain.com/accounts/123/details
PATCH-Methode
HTTP-PATCH-Anfragen werden verwendet, um einen Teil einer Ressource zu aktualisieren.
Wie PATCH können auch PUT-Anfragen eine Ressource ändern. Denken Sie jedoch so darüber: Verwenden Sie PATCH, wenn Sie nur einen Teil der Ressource aktualisieren möchten, und PUT, wenn Sie das gesamte Objekt ersetzen möchten.
Beachten Sie jedoch, dass die Verwendung von PATCH in Ihrer Anwendung auf Probleme stoßen kann:
Nicht alle Webbrowser, Server und Frameworks unterstützen PATCH vollständig. Internet Explorer 8, PHP, Tomcat, Django und viele weitere unterstützen PATCH beispielsweise entweder gar nicht oder verarbeiten die Methode nicht korrekt.
Wie verwenden Sie GET/POST/PUT/DELETE-Methoden ohne Code?
Die Antwort ist klar: Verwenden Sie dafür No-Code-/Low-Code-Tools! Latenode ist die perfekte Wahl, denn es verfügt über einen HTTP-Anfrage-Node, mit dem Sie jede dieser Methoden nutzen können, um sich mit JEDER App zu integrieren, die über eine API verfügt.
Sie können diese Vorlage verwenden, die einige Funktionen von HTTP-Anfragen nutzt.
Fazit
Jetzt, da Sie über Kenntnisse zu HTTP-Anfragemethoden wie GET, POST, PUT, DELETE und PATCH verfügen, können Sie Ihr Verständnis von APIs auf die nächste Stufe heben.
Unsere Erkundung endet hier jedoch nicht. Wir laden Sie ein, unseren abschließenden Artikel – REST API Headers & Body – zu lesen, um Ihre API-Kenntnisse weiter zu vertiefen.
Wenn Sie Fragen haben oder sich weiter austauschen möchten, laden wir Sie herzlich ein, unserer Discord-Community beizutreten. Dort teilen wir Erkenntnisse und bieten Unterstützung, während Sie Ihre Reise durch die Welt der Automatisierung fortsetzen.
Optimieren Sie Ihre Geschäftsprozesse mit Latenode – der besten Automatisierungsplattform für Sie
