获取谱面列表或详情

支持多种 action：list（获取列表），detail（获取详情），history（获取谱面历史事件，返回 data: [ { type, ts, actor_id, actor_name?, detail? } ]；type='audit' 为管理操作审计：delete/hide/reject/restore/re-review/vote/publish_approved/publish_rejected，携带 actor_name/action/detail）。moderate / like 仅 POST / DELETE 支持，GET 不支持。list/detail/history 响应均可能命中 Redis 与进程内短期缓存；上传、删除、审核投票、发布审批、管理员状态更新会主动失效对应的列表/详情/历史缓存。history 响应的远端缓存 TTL 约 300 秒。

返回响应

🟢200

application/json

成功。action=list 时 data 为下述对象数组（列表行含 meta_url、extra_url(null)、assets_manifest([])）；action=detail 时 data 为单个谱面详情对象（Chart 字段 + detail 专属字段：file_url、description、play_count、like_count、published、offset_val、uploader_avatar、is_liked）；action=history 时 data 为事件行数组。

Bodyapplication/json

示例

{
    "data": [
        {
            "id": 3,
            "title": "エゴイスト",
            "artist": "大沼パセリ feat. flower",
            "charter": "LPI -\"EGOIST\"-",
            "difficulty": "Cloudburst",
            "level": "11.5",
            "bpm": "180",
            "cover_url": "https://file.starsriverorg.cn/charts/1765342698163-image.png",
            "chart_url": "https://file.starsriverorg.cn/charts/1765342698163-chart.json",
            "meta_url": "https://file.starsriverorg.cn/charts/pkg_1765342698163/meta.json",
            "audio_url": "https://file.starsriverorg.cn/charts/1765342696394-audio.mp3",
            "allow_ai_learning": false,
            "created_at": "2025-12-10T04:58:22.476Z",
            "status": "approved",
            "uploader_id": 2,
            "uploader_name": "SeRazon_test"
        },
        {
            "id": 2,
            "title": "エゴイスト",
            "artist": "大沼パセリ feat. flower",
            "charter": "LPI -\"EGOIST\"-",
            "difficulty": "Cloudburst",
            "level": "11.5",
            "bpm": "180",
            "cover_url": "https://file.starsriverorg.cn/charts/1765295953923-image.png",
            "chart_url": null,
            "meta_url": "https://file.starsriverorg.cn/charts/recovered/2/meta.json",
            "audio_url": "https://file.starsriverorg.cn/charts/1765295948409-audio.mp3",
            "allow_ai_learning": false,
            "created_at": "2025-12-09T15:59:22.170Z",
            "status": "approved",
            "uploader_id": 1,
            "uploader_name": "SeRazon"
        }
    ]
}

🟠400

🟠401

🟠403

🟠404

🔴500

获取谱面列表或详情

请求参数

请求示例代码

返回响应