状態を変更
PATCH HTTPメソッド
PATCHリクエストはリソースに部分的な変更を適用します。
意味
クライアントは対象リソースを部分的に変更する変更ドキュメントを送信します。
よくある用途
リソースの一部のみを変更すべきで、サーバーがそのパッチドキュメント形式をサポートしている場合にPATCHを使います。
確認すべきこと
パッチのメディアタイプ、Accept-Patchのサポート、バリデーションエラー、そして競合や前提条件のレスポンスを確認します。
リクエスト例
PATCH /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/merge-patch+json
{"title":"Updated title"}プロパティ
- 安全
- いいえ。このメソッドはサーバーの状態を変更できます。
- 冪等
- いいえ。リクエストを繰り返すと、別の効果が生じる可能性があります。
- キャッシュ可能
- レスポンスが明示的に許可した場合のみ。
- リクエストボディ
- 通常はあり