feat: swagger format

This commit is contained in:
Blizzard
2026-02-11 16:22:17 +08:00
parent 112a1f439c
commit 69e59b0e36
14 changed files with 54 additions and 44 deletions
+12 -9
View File
@@ -16,18 +16,19 @@ type WikiClassApi struct{}
// @Tags 百科分类
// @Summary 添加分类
// @Security BearerAuth
// @accept json
// @accept application/json
// @Produce application/json
// @Param data body plantReq.CreateWikiClass true "添加分类"
// @Success 200 {string} string "{"success":true,"data":{},"msg":"发布成功"}"
// @Router /wiki-class/add [post]
func (a *WikiClassApi) AddClass(c *gin.Context) {
var req plantReq.CreateWikiClass
if err := c.ShouldBindJSON(&req); err != nil {
err := c.ShouldBindJSON(&req)
if err != nil {
response.FailWithMsg("请求参数错误", c)
return
}
err := wikiClassService.AddClass(req)
err = wikiClassService.AddClass(req)
if err != nil {
global.Logger.Error("添加百科分类失败", zap.Error(err))
response.FailWithMsg("添加百科分类失败", c)
@@ -40,18 +41,19 @@ func (a *WikiClassApi) AddClass(c *gin.Context) {
// @Tags 百科分类
// @Summary 修改分类(可直接传入ossId修改图片)
// @Security BearerAuth
// @accept json
// @accept application/json
// @Produce application/json
// @Param data body plantReq.UpdateWikiClass true "修改分类"
// @Success 200 {string} string "{"success":true,"data":{},"msg":"发布成功"}"
// @Router /wiki-class/update [post]
func (a *WikiClassApi) UpdateClass(c *gin.Context) {
var req plantReq.UpdateWikiClass
if err := c.ShouldBindJSON(&req); err != nil {
err := c.ShouldBindJSON(&req)
if err != nil {
response.FailWithMsg("请求参数错误", c)
return
}
err := wikiClassService.UpdateClass(req)
err = wikiClassService.UpdateClass(req)
if err != nil {
global.Logger.Error("修改百科分类失败", zap.Error(err))
response.FailWithMsg("修改百科失败", c)
@@ -64,14 +66,15 @@ func (a *WikiClassApi) UpdateClass(c *gin.Context) {
// @Tags 百科分类
// @Summary 分类分页
// @Security BearerAuth
// @accept json
// @accept application/json
// @Produce application/json
// @Param data body request.PageInfo true "分页获取分类列表"
// @Success 200 {string} string "{"success":true,"data":{},"msg":"获取成功"}"
// @Router /wiki-class/page [post]
func (a *WikiClassApi) ClassPage(c *gin.Context) {
var req request.PageInfo
if err := c.ShouldBindQuery(&req); err != nil {
err := c.ShouldBindQuery(&req)
if err != nil {
response.FailWithMsg("请求参数错误", c)
return
}
@@ -93,7 +96,7 @@ func (a *WikiClassApi) ClassPage(c *gin.Context) {
// @Tags 百科分类
// @Summary 删除分类
// @Security BearerAuth
// @accept json
// @accept application/json
// @Produce application/json
// @Param data body request.IdsReq true "删除分类"
// @Success 200 {string} string "{"success":true,"data":{},"msg":"删除成功"}"