删除谱面 (兼容旧客户端，使用 POST 代替 DELETE)

POST

/api/v2/charts

兼容旧客户端的删除入口（语义同 DELETE /charts?action=delete&id=...，软删除：不物理移除，仅将 Charts.status 置为 hidden，关联数据全部保留，仅管理角色可见可恢复）；并支持 action=moderate 管理操作（body 含 chartId 与 action，权限 admin/reviewer/moderator，上传者不可操作；hide=隐藏/reject=拒绝/restore=恢复/re-review=重新审核，其中 re-review 会清空 ChartVotes 重新进入审核）。成功删除后服务端会失效谱面列表缓存和该谱面的详情缓存。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Query 参数

Body 参数application/json

示例

{
    "chartId": 0,
    "action": "hide"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/charts?action=&id=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "chartId": 0,
    "action": "hide"
}'

返回响应

🟢200

成功（删除为软删除，返回 status:'hidden'；moderate 返回更新后的谱面状态）

该响应没有 Body

🟠400

🟠401

🟠403

🟠404

🟠405

🔴500

修改于 2026-10-07 10:19:10

删除谱面

Studio 管理：获取审核队列（支持待审核 / 上架申请 / 已通过 / 已上架 / 已拒绝等）