如何使用swagger-ui在body的模式中显示数组

时间:2016-07-07 07:09:50

标签: arrays swagger swagger-ui

我尝试使用swagger-ui记录所有API请求,但确实存在以下问题:

我需要通过请求发送的正文是一组ID

{
  "elements": [
    {
      "id": 1
    },
    {
      "id": 2
    }
  ]
}

要显示架构,必须将架构类型设置为array。这导致了问题,我确实有额外的括号,这些括号不是我需要提供的身体的一部分。

[
  {
    "elements": [
      {
        "id": 0
      }
    ]
  }
]

我的swagger.yml的创建方式如下所述。 是否有可能摆脱括号,以便我的架构适合我需要提供的身体?

paths:
 /elements/remove:
  patch:
   security: ...
   summary: ...
   parameters:
    - name: Body
      in: body
      description: ...
      required: true
      schema:
       $ref: '#deveinitions/Elements'


definitions:
 Element_neseted:
    type: object
    required:
      - id
    properties:
      id:
        type: integer
        format: int64
        description: >-
          Id is in request body for update of events.

 Elements:
  type: object
  required:
      - elements
    properties:
      assets:
        type: array
        title: "elements"
        items:
          $ref: '#/definitions/Element_neseted'

0 个答案:

没有答案