Idempotent
HTTP-Methode PUT
PUT-Anfragen ersetzen die Zielressource durch den Anfrageinhalt.
Bedeutung
Der Client fordert den Server auf, die enthaltene Darstellung unter der Ziel-URI zu speichern.
Häufige Verwendungen
Verwenden Sie PUT, wenn der Client eine bekannte Ressource ersetzt oder unter eine bekannte URL schreibt.
Was zu prüfen ist
Prüfen Sie, ob die Anfrage die vollständige Ersatzdarstellung enthält und ob Vorbedingungs-Header versehentliches Überschreiben bei Bedarf verhindern.
Beispielanfrage
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}Eigenschaften
- Sicher
- Nein. Diese Methode kann den Serverzustand ändern.
- Idempotent
- Ja. Das Wiederholen derselben Anfrage sollte dieselbe beabsichtigte Wirkung haben.
- Cachefähig
- Nein
- Anfragekörper
- Normalerweise ja
Referenzen
- Registry
- IANA HTTP Method Registry
- Spezifikation
- RFC 9110 Section 9.3.4
- Leitfaden
- MDN PUT