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

Question

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

Answer 1

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

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

您还可以选择声明“操作的状态或结果的表示”长度为零字节，在这种情况下，您可以使用200 OK和内容长度header。