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

GET

/api/v2/studio

action=queue 将返回统一队列（默认 filter=pending_queue）。支持额外 query 参数 filter（pending_queue|pending|publish_requests|approved|published|rejected_review|rejected_publish）、page、limit、q（搜索）。注意：队列结果会被短期缓存（默认 TTL ~5 秒），在投票/审批/上架申请后会立即失效。返回条目会包含 cover_url 与 chart_url（若有），对于上架申请条目还会包含 request_id（PublishRequests 表主键）。若设置 FILE_CDN_DOMAIN，URL 会在响应时自动替换为 CDN 域名。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/studio?action=&filter=&page=&limit=&q=' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

成功。返回审核队列数组（含 cover_url、chart_url；上架申请条目含 request_id）。

Bodyapplication/json

示例

{
    "data": [
        {
            "id": 0,
            "title": "string",
            "cover_url": "string",
            "chart_url": "string",
            "uploader_id": 0,
            "uploader_name": "string",
            "type": "review",
            "request_id": 0,
            "requested_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "page": 0,
    "limit": 0
}

🟠401

🟠403

🔴500

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

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

Studio 操作：投票 / 申请上架 / 处理上架