成绩互动

成绩互动接口用于读取曲目互动汇总、评论、点赞/点踩和内容反馈。所有操作都受账号权限和服务内容规则限制。

获取互动数据

POST /chart/social/get

{
  "token": "<TOKEN>",
  "musicIds": [10001, 10002],
  "includeReviews": false
}

musicIds 可省略以读取当前账号可见的全部汇总；读取单曲时建议只传一个或少量编号。

响应：

{
  "success": true,
  "msg": "success",
  "me": "<USER_NAME>",
  "social": [
    {
      "musicId": 10001,
      "likeCount": 3,
      "dislikeCount": 0,
      "commentCount": 1,
      "updatedAt": "2026-09-10T00:00:00Z"
    }
  ],
  "comments": [
    {
      "musicId": 10001,
      "comments": []
    }
  ],
  "reviews": [],
  "deleteList": []
}

曲目点赞/点踩

POST /chart/reaction

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "action": "like"
}

action 可用 like 或 dislike。成功后使用响应中的 social 更新本地显示。

发布评论或回复

POST /chart/comment/add

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "parentId": "",
  "content": "这条评论内容"
}

省略或传空 parentId 表示发表评论；填写已有评论的 id 表示回复。

删除评论

POST /chart/comment/del

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "commentId": "<COMMENT_ID>"
}

客户端应只对当前用户拥有删除权限的评论显示删除按钮。

评论点赞/点踩

POST /chart/comment/reaction

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "commentId": "<COMMENT_ID>",
  "action": "like"
}

提交内容反馈

POST /chart/review/request

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "reason": "请说明需要处理的原因"
}

撤回自己的反馈：

POST /chart/review/withdraw

{
  "token": "<TOKEN>",
  "musicId": 10001,
  "commentId": "<REPORT_COMMENT_ID>"
}

审核权限接口

具有审核权限的账号可以使用：

• POST /chart/review/list：按 status 获取反馈列表；
• POST /chart/review/history：获取处理记录；
• POST /chart/review/decision：传入 musicId、action（hide/show）和可选 note。

这些接口只适合在明确显示审核入口的客户端中使用。普通用户应使用反馈接口，不要调用审核接口。