我有一个定义HEAD操作的Swagger规范:
head:
description: show flight exist or not.
parameters:
- name: flight_no
in: path
type: string
description: Flight_no
required: true
produces:
- application/json
- application/xml
responses:
200:
description: success response
schema:
type: array
items:
$ref: '#/definitions/Data'
'404':
description: flight does not exist
在Swagger UI v.2中,这个HEAD操作没有“试用”按钮。我如何为HEAD添加“试用”按钮?
3条答案
按热度按时间pod7payv1#
您可以尝试 Swagger UI 3.0 - HEAD在此版本中默认为“试用”。
如果使用Swagger UI 2.0,HEAD默认是禁用的,需要在index.html中Swagger UI初始化代码的
supportedSubmitMethods
列表中显式启用:顺便说一下,HEAD响应中的
schema
并不是很有用,因为HEAD不应该返回一个实际的主体--只返回头部。qni6mghb2#
在java中,你可以在swagger config类中添加一个bean来完成这个任务:
基本上,它会将
supportedSubmitMethods
放置到[]
。ki0zmccv3#
您需要通过“head”值扩展DEFAULT_SUBMIT_METHODS。