在 swagger 文档中命名一个数组

Question

正在尝试获取要显示的数组字段的名称。尝试以下操作：

{
  history: []
}

我的文档中有：

      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/historyList'

在定义中...

  historyList:
    type: array
    items:
      $ref: '#/definitions/History'  #my object of many values

我已经在响应中的架构级别和数组本身中尝试过该名称，它总是以“数组”的形式出现。大摇大摆的医生，我在这方面肯定缺少一些明显的东西。

谢谢

Answer 1

而且，一如既往，我 post 一个问题，然后在 10 分钟后解决....

所以，这并不明显，但这是我将数组命名为“history”的方式

historyList:
  type: object
  properties:
    history:
      type: array
      items:
        $ref: '#/definitions/history'

因此您需要将您的数组放入一个对象中并命名该对象。