无法理解一件事,为什么swag init
命令会生成所有内容,除了SecurityDefinition
块
例如,这是我在 main 函数上的代码:
// @title Swagger API
// @version 1.0
// @description This is a documentation for PlatOps Core tool.
// @termsOfService http://platops.com/
// @license.name Apache 2.0
// @license.url http://www.apache.org/licenses/LICENSE-2.0.html
// @host test.com
// @BasePath /v2
// @securityDefinitions.apikey Bearer
// @in header
// @name Authorization
以及我如何使用:
// GetUser godoc
// @Summary Retrieves users list
// @Tags users
// @Accept json
// @Produce json
// @Success 200 {object} string
// @Failure 400,404 {object} string
// @Failure 500 {object} string
// @Router /api/users/ [get]
// @Security Bearer
由此,它生成了一切,这条路径也是,但里面没有 SecurityDefinition 块。
我正在尝试实现这个: https ://github.com/swago/swag#security
PS 如果我将已经生成的文本放在生成的 doc 文件中,它就可以工作了……那为什么它不能生成呢?
"securityDefinitions": {
"api_key": {
"type": "apiKey",
"name": "Bearer",
"in": "header"
},
}