RESTful 手册

我们应该在什么情况下使用 PATCH 方法?

[PATCH] 方法可以用来更新资源的一个组成部分。举个例子，当你仅需更新资源的某一项，[PUT] 一个完整的资源就显得很累赘同时会消耗更多带宽。

PATCH /user/jthijssen HTTP/1.1
<user>
    <firstname>Joshua</firstname>
</user>

值得一提的是 [PUT] 方法是幂等的。对同一资源的多次 [PUT] 操作，不应该返回不同的资源，而对同一资源的多次 [POST] 可以生产多个资源。

另请参见

• RFC 5789 - HTTP PATCH

注意：

• [PATCH] 即不完全也不幂等。
• 一个 API 实现 [PATCH] 必须是元子的。它一定不能出现只 [GET] 到被 [PATCH] 更新了一半的资源。