模块:评论模块 接口数:6 更新:2026-09-05 16:11

评论模块

控制层 TypechoCommentsController @author buxia97 @date 2021/11/29

类路径CommentsController 前缀/typechoComments

1. commentsList

接口路径GET/POST /typechoComments/commentsList

权限:公开接口;但当系统配置 isLogin=1 时会强制要求登录

接口说明:查询评论 @param searchParams Bean对象JSON字符串 @param page 页码 @param limit 每页显示数量

请求参数

参数名 类型 必填 默认值 说明
searchParams String(JSON 字符串,需后端解析) - JSON 字符串,需后端解析
page Integer 1
searchKey String -
order String created
limit Integer 15
token String -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考


2. commentsAdd

接口路径GET/POST /typechoComments/commentsAdd

权限:需要登录(普通用户及以上)

接口说明:添加评论 @param params Bean对象JSON字符串

请求参数

参数名 类型 必填 默认值 说明
params String(JSON 字符串,需后端解析) - JSON 字符串,需后端解析
token String -
text String -
atUsers String -
verifyCode String -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考


3. commentsEdit

接口路径GET/POST /typechoComments/commentsEdit

权限:需要登录(普通用户及以上)

接口说明:编辑

请求参数

参数名 类型 必填 默认值 说明
params String(JSON 字符串,需后端解析) - JSON 字符串,需后端解析
token String -
text String -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}

4. Audit

接口路径GET/POST /typechoComments/commentsAudit

权限:需要管理员或编辑权限

接口说明:评论审核

请求参数

参数名 类型 必填 默认值 说明
key String -
token String -
type Integer -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考


5. commentsDelete

接口路径GET/POST /typechoComments/commentsDelete

权限:需要登录(普通用户及以上)

接口说明:评论删除

请求参数

参数名 类型 必填 默认值 说明
key String -
token String -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考


6. commentLikes

接口路径GET/POST /typechoComments/commentLikes

权限:需要登录(普通用户及以上)

接口说明:评论点赞

请求参数

参数名 类型 必填 默认值 说明
id Integer -
token String -

响应说明

{
  "code": 1,
  "msg": "",
  "data": ...
}