json - 修补多个资源

Question

简短:启用 PATCH 请求来更新资源集合(不仅是单个资源，还是单独更新)是否符合标准、RESTful 以及其他好主意？

长:

我正在考虑公开一种方法来启用对我的资源集合的批量、原子更新。示例:

PATCH /url/myresources
[
    {
        "op": "add",
        "path": "/1",  // ID if the individual resource
        "value": 
        {
            ... full resource representation ...
        }
    },
    {
        "op": "remove",
        "path": "/2"
    },
    {
        "op": "replace",
        "path": "/3/name",
        "value": "New name"
    }
]

上下文是商业解决方案的公共(public) API。允许此类 PATCHes 的好处是原子性和批处理友好性，无需垃圾请求、单独处理故障等。

我咨询过https://www.rfc-editor.org/rfc/rfc6902和 https://www.rfc-editor.org/rfc/rfc5789但如果符合要求，则找不到明确的答案。 RFC 大多指的是“资源”，但也可以这样处理资源的集合。

这是个好主意吗？有更好的选择吗？

Answer 1

我喜欢这个想法。集合也是一种资源。因此，对其采取行动是非常好的 REST。

PATCH 请求的语义是请求正文中未列出的每个子资源都将保持原样。 列出的每个子资源都将按照描述进行更改。是的，我觉得这听起来不错。

只要请求的每个段都可以在单个请求中执行，我认为没有问题。您的“一体式”请求和像这样的单个请求都可以。

PATCH /url/myresources/1
{
    "op": "add",
    "value": 
    {
        ... full resource representation ...
    }
}