如何在 OpenAPI 2.0 中定义对象数组？

Question

我是使用 swaggerhub 的新手。我需要定义一个API，并且请求需要看起来像这样的json：

{
  "acountNumber": "1234564545444854",
  "warningTypes":[
    {
      "warningCode": 122,
      "warningMessage": "string message"
    }    
   ]  
}

此刻我有这个：

definitions:
  WarningCodes:
    type: object
    required:
    - accountNumber
    - warningCodes
    - messages
    properties:
      accountNumber:
        type: string
        example: 1234567890
      warningTypes:
        type: array
        items:
          type: object
          properties:
            warningCode:
            type: integer
            warningMessage:
            type: string

不以这种方式工作。

Answer 1

似乎它需要一个新实体，像这样

definitions:
  WarningCodes:
    type: object
    required:
    - accountNumber
    - warningCodes
    - messages
    properties:
      accountNumber:
        type: string
        example: '1234567890'

      warningTypes:
        type: array
        items:
          $ref: '#/definitions/WarningType'

  WarningType:
    type: object
    properties:
      warningCode:
        type: integer
        example: 122
      warningMessage:
        type: string
        minLength: 0
        maxLength: 256
        example: test1,test