Swagger 标头定义

我似乎找不到是否可以声明标头对象以便在响应标头中重用它，有为响应模式定义对象的示例，但它不会转置为响应标头。我只设法制作了一个可重用的响应对象，如下所示：

responses:
  DownloadOk:
    description: Dowload Ok
    headers:
      Content-Length:
        description: response length
        type: integer 
      Document-Length:
        description: document length
        type: integer 

但正如我所说，我只想保留标题部分。

这是我想使用它的地方：

responses:
    200:
      description: Dowload Ok
      headers:
        $ref: '#/definitions/DowloadOk'

根据 Swagger/OpenAPI 规范，你不能。定义 http://swagger.io/specification/#definitionsObject必须包含模式对象 http://swagger.io/specification/#schemaObject，并且这些不允许任意属性，但允许 JSON 模式的特定子集（请参阅the link http://swagger.io/specification/#schemaObject).

你能够定义一个响应对象 http://swagger.io/specification/#responseObject并引用该内容，因为招摇对象 http://swagger.io/specification/#swaggerObject具有全球性responses财产。标题没有这样的东西。无论如何，现在还不行。请求这样的功能可能是值得的。