yaml - Swagger 不呈现请求体

Question

我有以下符合 openapi 3.0 的 yaml 文件，我正在尝试通过 swagger 呈现该文件。 yaml文件没有报错，但是requestBody未在 swagger GUI 上呈现。我刚收到一个 parameters字段为空但没有为请求正文呈现任何内容，我也没有收到任何错误。截图如下。

paths:
  /my-api:
    post:
      summary: My API Summary
      description: My API Description
      tags:
        - Cost Center
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: array
                  items:
                    $ref: '#/components/schemas/ReqBodyStruct'

获得 swagger gui 中也显示的 RequestBody 的方法是什么？我错过了什么吗？

Answer 1

根据这两个问题OAS 3.0: Support for media type examples (aka request/response body examples) #3437和 Examples are not showing #2651从 Swagger UI github 页面这应该在版本 3.23.0 中修复(2019 年 6 月 29 日)。