在使用swagger编辑器时,我创建了下面的YAML,它显示了响应对象的示例。它在swagger编辑器中正确显示。当我下载JSON并在swagger用户界面中显示它时,该示例完全丢失。
/person/{email}/create:
post:
summary: Create a new account
tags:
- Person
parameters:
...
responses:
201:
description: The new SQL ident and sport details
examples:
application/json: |
[
12,
[
{
"sql_idnet" : 12,
"name" : "Basketball"
},
{
"sql_ident" : 13,
"name" : "Ice Hockey"
}
]
]
这可能是因为响应没有模式
-在Swagger中,这意味着响应没有主体。
也就是说,SwaggerUI3.0正确地显示了这个例子。
SwaggerUI和Swagger Editor目前不支持多个示例。您可以关注本期以获取更新。