未分類
12 6 月 2020

HTTP PATCH 的问题

HTTP PATCH 的问题

資深大佬 : acr0ss 7

作为一个 CRUD boy，最近想要努力将 RESTful 付诸实践。 但是有一个问题一直困扰着我：

修改数据该选用哪个 verb ？ PUT 、POST 或是 PATCH ？

从语意来说，POST 是新增，PUT 是修改，PATCH 是部分修改。 从幂等性来说，POST 是非幂等的，而 PUT 和 PATCH 是幂等的。

现在我有两个问题：

  1. 如果是 incr field 操作，PUT 和 PATCH 无法做到幂等，这种情况下各位老哥会如何抉择?
  2. PATCH 这个动词，实践中会使用吗？使用的多吗？
大佬有話說 (4)

  • 資深大佬 : yyfearth

    inc field 这个操作本身不是幂等的
    直接放到 PUT 和 PATCH method 都不合适

    比如 /object/11111/count 需要 inc 操作
    那么 PUT 和 PATCH 都应该是直接对 count 进行赋值 而不是 INC 的操作
    而赋值是幂等的

    如果非要支持 INC 操作 那么应该用 POST 比如 POST /object/11111/count/inc 或者 POST /object/11111?op=incCount 这样比较合适
    PUT 一般对应 db 的 replace 功能 替换记录
    PATCH 一般是 update 功能 部分修改

  • 資深大佬 : askfermi

    PATCH 应该是不必幂等的。

    “A PATCH is not necessarily idempotent, although it can be.”

    ref. https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH

  • 資深大佬 : jadec0der

    incr field 具体是什么操作呢？

    如果非要幂等的话可以考虑先 POST 一个 transaction，然后用 PUT/PATCH 把 transaction 状态改成确认。当然我觉得这就太教条了。

  • 主 資深大佬 : acr0ss

    @askfermi 这个文档写的很详细，也回答了我的问题，感谢！