如何使用 yaml 大摇大摆地描述响应对象？

Question

我们对 /papers/15 有以下 json 响应

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

有谁知道如何描述 swagger 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"