对象数组的定义如下：
type: array
items:
type: object
properties:
prop1:
type: string
prop2:
type: integer
# etc.
在您的示例中，响应包含具有属性 balanceDisplaySettings 的对象，并且此属性包含对象数组 . 这可以定义如下：
paths:
/Path:
get:
responses:
200:
description: OK
schema:
type: object
properties:
balanceDisplaySettings:
type: array
items:
type: object
properties:
type:
type: string
label:
type: string
visible:
type: boolean
primary:
type: boolean
请注意，架构定义了响应结构，这意味着您无需在任何位置指定实际值( "Balance" ， "AvailableBalance" 等) . 但是，如果要在Swagger UI中显示帖子(包含2个对象的数组)中的示例，可以像下面这样添加它：
balanceDisplaySettings:
type: array
items:
type: object
properties:
type:
type: string
label:
type: string
visible:
type: boolean
primary:
type: boolean
example: #
- type: Balance
label: Current
visible: true
primary: false
- type: AvailableBalance
label: Available
visible: true
primary: true
最后，您可能希望拆分内联嵌套模式以使规范更加模块化 .
paths:
/Path:
get:
responses:
200:
description: OK
schema:
$ref: '#/definitions/MyResponseObject'
# |
definitions: # |
# TODO: better name # |
MyResponseObject: #
type: object
properties:
balanceDisplaySettings:
type: array
items:
$ref: '#/definitions/BalanceDisplaySetting'
example: # |
- type: Balance # |
label: Current # |
visible: true # |
primary: false # |
- type: AvailableBalance # |
label: Available # |
visible: true # |
primary: true # |
# |
BalanceDisplaySetting: #
type: object
properties:
type:
type: string
example: Balance
label:
type: string
example: Current
visible:
type: boolean
boolean:
type: boolean
)
)
