Swagger UI没有显示响应示例

Question

使用swagger-editor时，我创建了下面显示响应对象示例的YAML。它在swagger编辑器中正确显示。当我下载JSON并以swagger-ui显示时，示例完全丢失。

/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"
                }
              ]
            ]

Answer 1

这个可能因为响应没有schema - 在Swagger中这意味着响应没有正文。

也就是说，Swagger UI 3.0正确显示了这个例子。

Answer 2

Swagger UI和Swagger编辑器当前不支持多个示例。您可以按照this issue进行更新。