问题描述
我不确定是使用 POST 和 PATCH 的组合,还是只为我的用例提供 PUT 请求更好。
如果我正在创建以下资源:
POST /customer
firstname: John
lastname: Smith
email: j.smith@web.com
(response -> customer created with id '1')
之后是否可以使用 PATCH 请求来更新一个现有值(在本例中为电子邮件)并向资源添加新字段和值(生日)?
PATCH /customer/1
firstname: John
lastname: Smith
email: johnny.smith@gmail.com
dateofbirth: 1970-01-01
在这种情况下,出生日期已经是招摇定义的一部分。
解决方法
之后是否可以使用 PATCH 请求来更新一个现有值(在本例中为电子邮件)并向资源添加新字段和值(生日)?
是的。如果您可以在补丁文档中描述要进行的更改,则可以使用 PATCH。
您不需要在所有支持 PATCH 的资源上都支持 PUT,但考虑到方法语义的相似性,不支持 PUT 的 PATCH 支持有点奇怪。
您通常希望使用标准化的补丁文档,而不是滚动您自己的补丁文档。例如,对于 application/json
文档,您通常希望支持 application/merge-patch+json
、application/json-patch+json
或两者。
找到好的 patch document representation for plain text 文件更难。