评论

评论系统接口，支持嵌套回复

获取文章评论

GET /api/posts/:id/comments

响应：

{
  "ok": true,
  "comments": [
    {
      "id": "评论ID",
      "post_id": "文章ID",
      "author": "评论者",
      "content": "内容",
      "date": "2025-01-01T00:00:00Z",
      "status": "approved",
      "parent_id": null
    }
  ]
}

发表评论

POST /api/posts/:id/comments

请求体：

{
  "author": "评论者名称",
  "content": "评论内容",
  "parentId": "父评论 ID（可选）"
}

无需认证，公开接口。有 IP 频率限制。

全局评论列表（管理）

GET /api/comments
Authorization: Bearer <token>

查询参数： status（approved/pending/空）、page、pageSize

响应包含 post_title 字段，方便管理后台展示。

更新 / 删除

PUT    /api/comments/:id    # 更新状态 {"status": "approved"}
DELETE /api/comments/:id    # 删除

都需要认证。

嵌套回复

评论通过 parent_id 支持一级嵌套：

评论 A
├── 回复 A1 (parent_id: A)
└── 回复 A2 (parent_id: A)
    └── 回复 A2-1 (parent_id: A2)

安全机制

机制	说明
XSS 防护	输入自动转义
SQL 注入	参数化查询
频率限制	每 IP 限频
Origin 校验	验证请求来源