如何使用yaml描述在swagger中的响应对象？

Question

我们有以下的/纸JSON响应/ 15

{ 
    "data": [ 
    { 
     "id": 1, 
     "title": "foo" 
    }, 
    { 
     "id": 2, 
     "title": "bar" 
    } 
    ], 
    "meta": { 
    "total": 15 
    } 
} 

有谁知道如何来形容它招摇YAML文件？

Answer 1

好的，我只是想出了如何做到这一点，以防有人需要id。 除专用模型定义部分（“定义”）外，还可以进行内联模型描述。上面的代码会是这样的：

responses: 
    "200": 
     description: Matched Objects 
     schema: 
     type: object 
     properties: 
      data: 
      type: object 
      properties: 
       authors: 
       type: array 
       items: 
        $ref: "#/definitions/object_with_id_and_title"