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