c# - 按 ID 或按类型和语言更新资源的 RESTful 约定

Question

目前我按类型和语言的 GET 请求只能返回一个文档:

GET /documents?type=invitation&language=en

id: 50
text: "I would like to invite..."

更新资源的正确的 Restful 约定是什么？

PUT /documents?type=invitation&language=en

??或者也许我应该只通过 id 更新资源？

PUT /documents/50

Answer 1

更新整个资源时通常使用 PUT。这里您只是发送资源数据的子集 - 因此您应该使用 PATCH。

您的网址应该是:

PATCH /documents/{id}

然后您就在请求负载中获得了要更新的所有数据:

{
   "type": "invitation",
   "language": "en"
}

因此，您现在每个请求仅更新一个对象，并使用适当的方法和资源表示法。