本网站可以通过分类标签帮助你快速筛选出你想看的文章,记住地址:www.Facec.cc

Swagger 注释生成接口

注解	  描述
@Summary	摘要
@Produce	API 可以产生的 MIME 类型的列表,MIME 类型你可以简单的理解为响应类型,例如:(json、xml、html) 等等
@Param	    参数格式,从左到右分别为:参数名、入参类型、数据类型、是否必填、注释
@Success	响应成功,从左到右分别为:状态码、参数类型、数据类型、注释
@Failure	响应失败,从左到右分别为:状态码、参数类型、数据类型、注释
@Router	    路由,从左到右分别为:路由地址,HTTP 方法
// @Summary 获取单个文章
// @Produce json
// @Param id path int true "文章ID"
// @Success 200 {object} Article "成功"
// @Failure 400 {object} string "请求错误"
// @Failure 500 {object} string "内部错误"
// @Router /api/v1/articles/{id} [get]
func (a Article) Get(c *gin.Context) {

}

# golang  

评论