如何在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 

然後大搖大擺編輯器顯示以下生成的文檔：

它是正確的嗎？

Answer 1

我覺得你有這個問題的答案已經一個，但即使文檔的緣故：

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