COLON был просто ошибкой в моем вопросе, а не по фактическому коду. Я боялся, что это должен был быть ответ. Спасибо
ьзуя это определение схемы:
schemas:
AllContacts:
type: array
items:
$ref: '#/definitions/ContactModel1'
example:
- id: 1
firstName: Sherlock
lastName: Holmes
- id: 2
firstName: John
lastName: Watson
Я получаю этот ожидаемый результат:
[
{
"id": 1,
"firstName": "Sherlock",
"lastName": "Holmes"
},
{
"id": 2,
"firstName": "John",
"lastName": "Watson"
}
]
Теперь я хотел бы повторно использовать пример Холмса для одного пользователя (ContactModel1
) и как часть массива пользователей (AllContacts
). Но если я использую приведенные примеры:
schemas:
AllContacts:
type: array
items:
$ref: '#/definitions/ContactModel1'
example:
Homes:
$ref: '#/components/examples/Homes'
Watson:
$ref: '#/components/examples/Watson'
examples:
Holmes:
value:
id: 1
first_name: Sherlock
last_name: Holmes
Watson:
value:
id: 2
first_name: John
last_name: Watson
Я получаю этот неожиданный результат в Swagger UI:
[
{
"value": {
"id": 1,
"first_name": "Sherlock",
"last_name": "Holmes",
},
"$$ref": "#/components/examples/Holmes"
},
{
"value": {
"id": 2,
"first_name": "John",
"last_name": "Watson",
},
"$$ref": "#/components/examples/Watson"
}
]
и похожий неожиданный пример дляGET /user/1
:
[
{
"value": {
"id": 1,
"first_name": "Sherlock",
"last_name": "Holmes",
},
"$$ref": "#/components/examples/Holmes"
}
]
Что я делаю неправильно?
Я использую этот документ в качестве ссылки:
https://swagger.io/docs/specification/adding-examples/#reuse