管理员 API

管理员接口用于登录后台、查看和管理评论、配置邮件通知和评论显示设置。

除登录接口外，所有管理员接口都需要在请求头中携带 Bearer Token。

Authorization: Bearer <token>

Token 通过登录接口获取。

接口分类

身份认证相关

• 管理员登录 POST /api/admin/login - 获取后续调用其他管理员接口所需的临时 Token

评论管理相关

• 获取评论列表 GET /api/admin/comments/list - 获取评论列表，用于后台管理页面展示
• 更新评论状态 PUT /api/admin/comments/status - 更新评论状态（通过 / 拒绝）
• 更新评论内容 PUT /api/admin/comments/update - 更新评论的详细信息
• 删除指定评论 DELETE /api/admin/comments/delete - 删除指定评论
• 加入 IP 黑名单 POST /api/admin/comments/block-ip - 将指定 IP 加入评论黑名单
• 加入邮箱黑名单 POST /api/admin/comments/block-email - 将指定邮箱加入评论黑名单

数据管理相关

• 导出所有评论数据 GET /api/admin/comments/export - 导出所有评论数据
• 导入评论数据 POST /api/admin/comments/import - 导入评论数据，支持 Twikoo / Artalk / VWD JSON
• 导出配置数据 GET /api/admin/export/config - 导出系统配置
• 导入配置数据 POST /api/admin/import/config - 导入系统配置
• 导出访问 / 点赞统计数据 GET /api/admin/export/stats - 导出访问量、按日统计和点赞明细
• 导入访问 / 点赞统计数据 POST /api/admin/import/stats - 导入访问和点赞统计
• 全量导出（备份） GET /api/admin/export/backup - 一次性导出评论 + 配置 + 统计数据
• 全量导入（恢复） POST /api/admin/import/backup - 从备份文件恢复全部数据

评论设置相关

• 获取评论配置 GET /api/admin/settings/comments - 获取评论配置
• 更新评论配置 PUT /api/admin/settings/comments - 更新评论配置

邮件通知配置相关

• 获取邮件通知配置 GET /api/admin/settings/email-notify - 获取邮件通知配置
• 更新邮件通知配置 PUT /api/admin/settings/email-notify - 更新邮件通知配置
• 测试邮件发送 POST /api/admin/settings/email-test - 测试邮件通知配置是否正确

统计数据相关

• 获取评论统计数据 GET /api/admin/stats/comments - 用于管理后台「数据看板」展示评论整体统计
• 获取点赞记录列表 GET /api/admin/likes/list - 获取各页面的点赞记录列表
• 获取点赞统计 GET /api/admin/likes/stats - 获取点赞 Top 页面列表

功能设置相关

• 获取功能设置 GET /api/admin/settings/features - 获取功能开关设置（评论点赞、文章点赞等）
• 更新功能设置 PUT /api/admin/settings/features - 更新功能开关设置