Есть ли способ закодировать многострочный пример в теле запроса? Если возможно, я бы хотел, чтобы мой документ OpenApi отображался следующим образом при работе под Swagger-UI.
До сих пор все, что мне удалось сделать, это однострочный пример, как показано ниже:
Вы мало говорите о выбранном вами языке для вашего API или о том, как вы создаете свой swagger.json...
Но да, это возможно. Вот несколько живых примеров:
http://swashbuckletest.azurewebsites.net/swagger/ui/index?filter=Company#/Company/Company_Post
код json для последнего выглядит так:
"delete": {
"tags": [
"Dictionary"
],
"operationId": "Dictionary_DeleteEcho",
"consumes": [
"application/json",
"text/json",
"text/html"
],
"produces": [
"application/json",
"text/json",
"text/html"
],
"parameters": [
{
"name": "guids",
"in": "body",
"required": true,
"schema": {
"type": "array",
"items": {
"format": "uuid",
"type": "string",
"example": "00000000-0000-0000-0000-000000000000"
},
"example": [
"00000000-0000-0000-0000-000000000000",
"00000000-0000-0000-0000-000000000000"
]
}
}
],
...
