Swagger 摆动头定义

Swagger 摆动头定义,swagger,swagger-ui,swagger-2.0,Swagger,Swagger Ui,Swagger 2.0,我似乎找不到是否可以声明header对象以便在响应头中重用它,有一些示例定义了响应模式的对象,但它没有转换到响应头。我只成功创建了一个可重用的响应对象,如下所示: responses: DownloadOk: description: Dowload Ok headers: Content-Length: description: response length type: integer Document-Lengt

我似乎找不到是否可以声明header对象以便在响应头中重用它,有一些示例定义了响应模式的对象,但它没有转换到响应头。我只成功创建了一个可重用的响应对象,如下所示:

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规范,您不能。必须包含,并且这些不允许任意属性,但允许JSON模式的特定子集(请参阅)


您可以定义和引用,因为具有全局
响应
属性。没有这样的标题。无论如何,现在不是。请求这样的功能可能是值得的。

我也面临同样的问题。在他们申报的文件中

注意,目前OpenAPI规范不允许为不同的响应代码或不同的API操作定义公共响应头。您需要分别为每个响应定义标题


请参阅。

中的响应标题部分。我确实尝试了子集,但它不起作用。标题:文档长度:$ref:“#/definitions/DowloadOk”