rest - 在所有情况下我都应该从 POST 返回实体吗？

Question

据我了解，RESTful convention用于创建资源以返回完整或带注释的创建实体的 POST，但是根据我的经验，除非正在测试服务本身或客户端，否则该实体通常会被丢弃。

在创建面向公众的 API 时，我不是 REST 的奴隶，特别是当我认为出于可用性或架构原因它没有意义时，但我一直想知道但从未做过的一件事是返回 204 创建新实体(尤其是大型实体)的 POST 中没有内容。这可以减少发出大量请求的用户的带宽，并使我端的响应更快。

这是一种可以接受的做法还是会让你内心有些崩溃？请注意，出于测试原因，如果不提供端点来检索此实体，我不会考虑这一点。

编辑:我正在寻找轶事观察或具体示例来说明为什么这个特定用例可能有害，即使它有详细记录。

Answer 1

您链接到的文档包含您所问问题的答案:

If a resource has been created on the origin server, the response SHOULD be 201 (Created) and contain an entity which describes the status of the request and refers to the new resource, and a Location header (see section 14.30).

Responses to this method are not cacheable, unless the response includes appropriate Cache-Control or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent to retrieve a cacheable resource.