Swagger of List<Object> 类型示例

Question

我的回复中包含 List<Image> 个图像，如下所示。

  {
         images: [
          {
            "name": "ABC",
             "content": "This is text"
          },
          {
          "name": "ABC",
          "content": "This is text"
        }
       ]
  }

YAML 文件类似于以下示例。以下 YAML 文件是否有效并等同于上面的图像 JSON 响应？？？

responses:
     '200':
         description: 'Request is successful.'
         schema:
           $ref: '#/definitions/Images'

definitions:
   Images:
        type: array
        items:
          $ref: '#/definitions/Image'

   Image:
      type: object
      properties:
         name:
           type: string
         content:
           type: string
      required:
          - name
          - content

Answer 1

响应模式缺少包装器 属性 images。除此之外，你的定义是正确的。

更改您的 Images 架构如下：

definitions:
   Images:
       type: object
       properties:
           images:
               type: array
               items:
                   $ref: '#/definitions/Image'
       required:
           - images