Appearance
GET /api/v1/posts/:id/comments
获取指定文章的已审核评论列表。
查询参数:
page
1
page_size
20
POST /api/v1/posts/:id/comments
前台访客提交评论(默认进入 pending 待审核状态)。
pending
请求体示例:
{ "author": "访客", "email": "visitor@example.com", "content": "写得真好!" }
说明
GET /api/v1/admin/comments
获取后台评论列表。
status
approved
spam
keyword
post_id
GET /api/v1/admin/comments/stats
获取评论统计。
响应示例:
{ "code": 200, "data": { "total": 42, "approved": 30, "pending": 10, "spam": 2 }, "msg": "ok" }
PATCH /api/v1/admin/comments/:id
审核评论(修改状态)。
{ "status": "approved" }
可选值:approved / pending / spam
DELETE /api/v1/admin/comments/:id
删除评论。
评论 API
公共接口
GET /api/v1/posts/:id/comments获取指定文章的已审核评论列表。
查询参数:
page: 页码,默认1page_size: 每页数量,默认20POST /api/v1/posts/:id/comments前台访客提交评论(默认进入
pending待审核状态)。请求体示例:
说明
pending,需管理员审核后才会前台展示管理接口
GET /api/v1/admin/comments获取后台评论列表。
查询参数:
page、page_size: 分页status: 可选值approved/pending/spamkeyword: 搜索评论内容或作者post_id: 按文章 UUID 筛选GET /api/v1/admin/comments/stats获取评论统计。
响应示例:
PATCH /api/v1/admin/comments/:id审核评论(修改状态)。
可选值:
approved/pending/spamDELETE /api/v1/admin/comments/:id删除评论。