带有标题的响应 swagger-ui答案

【问题标题】：Response with headers swagger-ui带有标题的响应 swagger-ui
【发布时间】：2016-02-17 10:20:47
【问题描述】：

我正在使用Swagger-ui version 2.1.4，我已在本地托管它并为其提供了我自己的 Json 文件和 API，它可以很好地打开文档，但我想在响应消息中添加标题但我不知道该怎么做，我跟着swagger specification去做，但不幸的是我仍然没有成功。我的示例代码在这里。

 "responses" : {
           "200" : {
              "description" : "SUCCESSFULLY_RETRIVED",
              "schema" : {
                 "$ref" : "#/definitions/Object"
              }
           },
           "500" : {
               "description" : "UNKNOWN_SERVER_ERROR",
               "headers": {
               "X-Rate-Limit-Limit": {
               "description": "The number of allowed requests in the current period",
               "type": "integer"
               }                    
           }

        },
        "deprecated" : false
     }

【问题讨论】：

尝试在此处导入您的 swagger.json 文件：editor.swagger.io
您调用的 API 是否实际返回 X-Rate-Limit-Limit 标头？您可以尝试使用 Chrome Advance Rest Client 发送示例请求，并注意响应是否包含标头：chrome.google.com/webstore/detail/advanced-rest-client-appl/…
您能说出您在这里遇到的确切错误吗？我也许能帮上忙。

标签： swagger swagger-ui swagger-2.0

【解决方案1】：

回复很晚，但我在寻找类似要求的示例时偶然发现了这一点。你的东西应该可以工作，不知道为什么它不适合你。如果您提供了确切的错误，那将会有所帮助。

以下 yaml 对我来说可以正常工作，您的也应该可以正常工作。

    500:
      description: Customer creation error
      headers:
        Error-Id:
          description: the relevant 500 Error
          type: string

【讨论】：