Swagger openApi 规范 3.0 - 删除操作

Question

我正在使用 swagger openapi specification 3.0 从我的界面生成 swagger。我有一个删除方法，它接受请求正文。但是根据RFC7231 , DELETE 不接受任何请求体。还有 Swagger-request body这么说的。但是我的 API 旨在接受 DELETE 操作中的请求正文。在创建 swagger 时是否有任何解决方法，以便 DELETE 操作接受请求正文。目前我从 Swagger 的一代中得到的错误是，

Sematic error: DELETE operations cannot have a requestBody

Answer 1

不可以，您不能使用 OpenAPI 3.0 规范和 Swagger 工具来实现带有请求正文的 DELETE 请求。正如您正确指出的那样，HTTP RFC 表示 DELETE 请求正文具有 no defined semantics (因此应该避免)，并且 OpenAPI 3.0 特别禁止在主体没有定义语义的 HTTP 方法中使用主体。参见 this discussion对于某些上下文。

考虑更改您的 API 设计，例如，将 DELETE 正文替换为路径、查询字符串或 header 参数。查看RESTful Alternatives to DELETE Request Body一些想法。