服务器命令请求的 HTTP 响应正文

Question

我正在与我的团队一起解决一个关于 REST API 规范的问题。 我们有一种情况，在某些请求中，我们仅通过 HTTP 请求发送一些特定命令，例如：我们正在使用 POST（现在考虑 PATCH 请求）到端点：/server/startSomeOperation。后端开发人员告诉我们，这个请求只是告诉硬件在后端启动一些影响用户测量的功能，但实际上没有什么可以返回的。我的问题是： 我们是否应该（根据某些 REST API 规范）在我们知道除了 HTTP 状态代码之外不需要额外返回数据时总是返回此类请求的主体？ 到目前为止，我们一直严格遵循这样的规则，即每个请求需要返回某种类型的主体，但直到现在每个主体响应，即使它是对服务器的命令也是有意义的。

Answer 1

我们是否应该（根据某些 REST API 规范）在我们知道除了 HTTP 状态代码之外不需要额外返回的数据时总是返回此类请求的主体？

不 - 当您的回复的语义与这些代码的标准含义完全一致时，发送 204 No Content 或 205 Reset Content 是完全可以的。

您还可以选择声明“操作的状态或结果的表示”是零字节长，在这种情况下，您可以使用带有Content-Length 标头的200 OK。