服務器命令請求的 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。