删除谱面

DELETE

/api/v2/charts

软删除指定谱面：不物理移除，仅将 Charts.status 置为 hidden（隐藏），投票/上架申请/成绩/点赞/评论等关联数据全部保留。隐藏谱面仅 admin/moderator/reviewer 可检索和查看（上传者本人也不可见），可随时通过 moderate restore 恢复。成功删除后服务端会失效谱面列表缓存和该谱面的详情缓存，避免后续 GET /charts?action=list/detail 返回已删除谱面的旧数据。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://api.xhsr.org.cn/api/v2/charts?action=&id=' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

删除成功（软删除，谱面状态置为 hidden）

该响应没有 Body

🟠400

🟠401

🟠403

🟠404

🟠405

🔴500

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

获取谱面列表或详情

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