获取成绩

GET

/api/v2/scores

按 action 分发成绩查询：recent 返回当前用户的最近成绩列表（含用户名与谱面标题）；leaderboard 返回指定谱面的排行榜（需 chartId）；user 返回指定用户的历史成绩（需 user_id）。查询实时读库，不做结果缓存。

请求参数

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

成功。action=recent 返回最近成绩数组；leaderboard 返回排行榜数组；user 返回指定用户的成绩数组。

Bodyapplication/json

示例

{
    "data": [
        {
            "id": 0,
            "score": 0,
            "acc": 0,
            "rank": "string",
            "reality": 0,
            "achievement": "string",
            "created_at": "2019-08-24T14:15:22.123Z",
            "username": "string",
            "chart_title": "string"
        }
    ]
}

🟠400

🟠401

🟠403

🟠404

🔴500

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

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

上传成绩