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

Question

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

spec缺少一些例子，所以我猜是这样的：

  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