获取谱面元数据（不再服务端打包 zip）

GET

/api/v2/convert-zip

返回谱面相关元数据：chart/audio/cover URL、meta.json / extra.json URL 等，供客户端自行拉取资源。服务端不再打包返回 zip：传 download=1 或 format=zip 一律返回 403（服务端打包已禁用）。chartUrl 现以 Charts.chart_url 为准（不再使用废弃的 file_url）。可通过 inlineCover=1 临时请求内联图片（会增加响应时间，默认关闭）。

请求参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/convert-zip?chartId=2&source=local&inlineCover=0&includeChartJson=0&download=0&format=json'

返回响应

🟢200

application/json

成功返回谱面元数据（JSON）

Bodyapplication/json

示例

{
    "data": {
        "chartUrl": "string",
        "chartJson": "string",
        "audioUrl": "string",
        "coverUrl": "string",
        "coverData": "string",
        "metaUrl": "string",
        "extraUrl": "string",
        "title": "string",
        "isZip": true
    }
}

🟠400

🟠403

🟠404

🔴500

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

文件上传

工单: 列表 / 详情 / 统计