json - 基于 JSON 的 REST API 上的 PUT 最常见的预期行为是什么？文档替换或部分更新)？

Question

我知道有一个完整的 HTTP 方法的 RFC，但我想知道从 PUT 到 REST API 的预期行为会是什么以 Content-type: application/json 响应并接受 JSON 编码的正文。

• 是否希望用正文中传递的新 JSON 对象完全替换文档？
• 是否希望仅修改 JSON 正文中传递的属性？ (作为 PATCH 方法的推荐行为 RFC 5789 )。
• 如果 API 公开的文档不符合模式并且正文中的 JSON 对象具有当前文档中不存在的新属性怎么办？。它应该添加它们吗？

欢迎给我阅读任何评论或资源。

Answer 1

1) 和 2) PUT 表示替换。将其用于部分替换是不正确的。这就是 PATCH 的用途。

3) 这取决于您的应用程序逻辑。