swagger - 如何在 swagger 2.0 中声明集合资源模型？

Question

我不确定我应该如何在 swagger 上为集合资源声明模型。

该规范缺少一些示例，所以我猜是这样的：

  Class:
    required:
      - id
      - name
    properties:
      id:
        type: string
      name:
        type: string

  ClassList:
    type: array
    items:
      type:
        schema:
          $ref: Class

然后 swagger 编辑器显示以下生成的文档：

这是对的吗？

Answer 1

我想你已经得到了这个答案，但即使是为了记录：

ClassList:
  type: array
  items:
    $ref: #/definitions/Class