Sichere und idempotente Methoden

Eine Methode ist sicher, wenn sie den Serverzustand nicht verändert: GET, HEAD und OPTIONS. Eine Methode ist idempotent, wenn dieselbe Anfrage, auch wenn sie mehrmals gestellt wird, denselben Effekt hat wie eine einmalige Anfrage: GET, HEAD, OPTIONS, PUT und DELETE. Jede sichere Methode ist idempotent; das Umgekehrte gilt nicht, da eine DELETE-Anfrage den Zustand verändert und dennoch idempotent ist.

So funktioniert es

Diese Eigenschaften ermöglichen automatische Wiederholungsversuche. Ein Proxy, ein Browser oder eine HTTP-Bibliothek kann eine idempotente Anfrage nach einem Timeout ohne Nachfrage wiederholen, da eine Wiederholung die Situation nicht verschlimmern kann. POST- und PATCH-Anfragen sind weder sicher noch idempotent. Deshalb werden sie nicht automatisch wiederholt – und deshalb existiert der Idempotency-Key-Header, um einer POST-Anfrage die von Natur aus fehlende Eigenschaft zu verleihen.

Das Missverständnis

Idempotent bedeutet, "returns the same response" . Es bedeutet, dass er auf dem Server denselben Effekt hat. Ein zweiter DELETE-Befehl für dieselbe Ressource ist idempotent, obwohl der erste den Statuscode 204 und der zweite den Statuscode 404 zurückgibt: Der Endzustand – die Ressource ist gelöscht – ist identisch.

Probieren Sie es hier aus

`GET /starfleet/v1/tribbles` ist ein bewusstes Anti-Pattern: ein GET-Befehl, der die Anzahl bei jedem Aufruf verdoppelt. Er ist das deutlichste Beispiel dafür, wovor "safe" Sie schützen soll.

Quellen

Weitere Begriffe

REST-API — Eine API, die ein System als adressierbare Ressourcen modelliert, die mit Standard-HTTP-Methoden manipuliert werden.
ETag — Eine undurchsichtige Versionskennung für eine Repräsentation, die dazu dient, ein erneutes Senden zu vermeiden und widersprüchliche Schreibvorgänge zu erkennen.
PUT vs PATCH — PUT ersetzt eine Ressource durch die von Ihnen gesendete Repräsentation; PATCH wendet eine Reihe von Änderungen darauf an.
Wiederholen — Ein Antwortheader, der dem Client mitteilt, wie lange er warten soll, bevor er es erneut versucht, entweder in Sekunden oder als Datum.
Exponentielles Backoff — Eine Wiederholungsstrategie, bei der jede Wartezeit länger ist als die vorherige, wobei Zufallselemente hinzugefügt werden, damit die Clients nicht synchron wiederholen.
Zeitüberschreitung der Anfrage — Die maximale Wartezeit eines Clients auf eine Antwort, bevor er die Anfrage abbricht.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026