为服务 API 返回无效响应是一种好的做法吗？

Question

我打算构建 APIs 来执行 CRUD 操作。

我有以下 APIs:

1. 创建条目
2. 更新条目

对于 CreateEntry API，我接受 CreateEntryRequest 和 CreateEntryResponse 分别作为请求和响应结构。

对于 UpdateEntry API，我正在接受 UpdateEntryRequest 作为请求，我没有 returning 任何东西。

什么都不 return 是个好习惯吗？但是，对于 UpdateEntry API，如果 API 成功，客户端将获得 HTTP 200 响应。

仅更新​​ API 秒建模的最佳方法是什么？

Answer 1

如果客户端只需要更新成功的信息，或者如果你想节省带宽，那么 return 200 没有响应主体的更新是可以的。

但这实际上也取决于您所谈论的更新类型。您的更新是否以客户端必须发送条目的所有数据的方式设计？或者它更像是一个补丁，您只更新条目的一部分（或条目的子对象）。

如果是后者，我宁愿 return 条目的当前版本，因为自从您上次获取条目后，其他客户端可能也更改了条目的另一部分。或者至少确保在客户端更新后获取对象，如果更新请求的性能或带宽再次是您的优先级。