В каких случаях следует ставить «- » перед $ref: в OpenAPI (Swagger)?

Question

[Роми]

Не ухватываю систему, в каких случаях нужно писать например так:

- $ref: '#/components/schemas/User'

а когда так:

$ref: '#/components/schemas/User'

Проясните вопрос плз, кто знает :)

Что вообще этот дефис означает в OpenAPI?

Answer 1

[Lynn «Кофеман»]

Почитать про синтаксис YAML.
Дефис в начале строки означает «элемент массива»

Т.е. первая запись это
[ { "$ref": "#/components/schemas/User" } ]
а вторая просто
{ "$ref": "#/components/schemas/User" }

Comments

[Роми]

спасибо! это ответ.

Почитать про синтаксис YAML

хорошая идея! :)