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

Question

我正在尝试为现有API创建OpenAPI 3.0定义。它具有POST操作，并以标头值作为输入。请求正文为空。但是，后端API的编码非常差，即使主体为空，也期望请求标头0014。

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

Answer 1

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

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

Answer 2

使用时失眠：

  requestBody:
    content:
      application/json: {}

结果是这样的：（预览）

但是如果使用这个：

  requestBody:
    content:
      application/json:
        schema:      # Request body contents
          type: object

结果是：（预览）