Zustandsändernd
HTTP-Methode PATCH
PATCH-Anfragen wenden Teiländerungen auf eine Ressource an.
Bedeutung
Der Client sendet ein Änderungsdokument, das die Zielressource teilweise modifiziert.
Häufige Verwendungen
Verwenden Sie PATCH, wenn sich nur ein Teil einer Ressource ändern soll und der Server das Patch-Dokumentformat unterstützt.
Was zu prüfen ist
Prüfen Sie den Patch-Medientyp, die Accept-Patch-Unterstützung, Validierungsfehler sowie Konflikt- oder Vorbedingungsantworten.
Beispielanfrage
PATCH /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/merge-patch+json
{"title":"Updated title"}Eigenschaften
- Sicher
- Nein. Diese Methode kann den Serverzustand ändern.
- Idempotent
- Nein. Das Wiederholen der Anfrage kann eine weitere Wirkung erzeugen.
- Cachefähig
- Nur wenn die Antwort es ausdrücklich erlaubt.
- Anfragekörper
- Normalerweise ja
Referenzen
- Registry
- IANA HTTP Method Registry
- Spezifikation
- RFC 5789 Section 2
- Leitfaden
- MDN PATCH