如何在 OpenAPI 3.0 中添加没有正文的 POST 请求的内容类型？

Question

我正在尝试为现有 API 创建 OpenAPI 3.0 定义。它具有 POST 操作并将标头值作为输入。请求正文为空。Content-Type: application/json然而，后端 API 的编码非常糟糕，即使正文为空，也需要请求标头。

如何在 OpenAPI 3.0 中实现这一目标？看起来Content-Type在 OAS 3.0 中不被接受为有效的标头参数。

Answer 1

您可以添加requestBody与application/json媒体类型，但不能添加schema。

openapi: 3.0.2
...
paths:
  /something:
    post:
      parameters:
        ...
      requestBody:
        content:
          application/json: {}