在 RESTful API 上更新模型时，每个字段是否应该有一个更新端点？还是模型的一个端点？

【问题标题】：When updating a model on a RESTful API, should there be an update endpoint per field? or one endpoint for the model?在 RESTful API 上更新模型时，每个字段是否应该有一个更新端点？还是模型的一个端点？
【发布时间】：2022-01-13 20:31:56
【问题描述】：

对于 RESTful API，请考虑如下模型架构：

MyCoolObject {
  field_a
  field_b
  field_c
}

创建一个更新端点来更新模型（PUT）上的一个或多个字段是否更好？或者为每个字段创建一个端点，只更新该字段 (PATCH)？

【问题讨论】：

标签： database api rest architecture backend

【解决方案1】：

启发式：如何从 API 获取信息？

通常情况下，如果您将信息包含在其表示中包含所有信息的单个资源中...

GET /my-cool-object

那么您还应该使用相同的资源编辑该信息

PUT /my-cool-object
PATCH /my-cool-object
POST /my-cool-object

如果您从多个资源中获取信息（可能是通过链接）

GET /my-cool-object
GET /my-cool-object/a
GET /my-cool-object/b
GET /my-cool-object/c

那么你通常会在自己的资源中编辑信息

PUT /my-cool-object/a
PATCH /my-cool-object/a
POST /my-cool-object/a

【讨论】：