获取游玩记录

action=getsong：按 chartId 获取单个谱面的游玩记录（按 score 从高到低）；action=getall：分页获取全部游玩记录（按创建时间从新到旧）。除 download 外均需要 JWT 鉴权。chartId 为纯数字时按谱面 ID 匹配，否则按谱面哈希（chart_hash）匹配。返回 { data: { items, total } }；每条记录包含 props（客户端写入的 MilRecord::Properties，服务端原样返回）、file_url（本地 RSA 私钥解密后的明文记录文件）、file_hash（file_url 对应文件的 SHA-512 十六进制摘要，供下载后校验）与 create_time（Unix 时间戳，秒，含小数）。action=download 为兼容用的下载入口：记录本身已存为明文，通常直接访问 file_url 即可；若存储对象仍是加密态，该入口会用本地 RSA 私钥现场解密后返回明文并回写存储。列表结果最多缓存 60 秒，因此新上传的记录可能延后最多 60 秒才出现在列表中。

返回响应

🟢200

application/json

成功。返回 { data: { items, total } }；每条记录含 props、file_url、file_hash、create_time。

Bodyapplication/json

示例

{
    "data": {
        "items": [
            {
                "id": 0,
                "props": {
                    "username": "string",
                    "user_id": "string",
                    "online_id": "string",
                    "chart_hash": "string",
                    "chart_env": "string",
                    "game_version": "string",
                    "modifiers": "string",
                    "grade": "string",
                    "score": 0,
                    "score_accuracy": 0,
                    "score_exact_count": 0,
                    "score_perfect_count": 0,
                    "score_great_count": 0,
                    "score_good_count": 0,
                    "score_bad_count": 0,
                    "score_miss_count": 0,
                    "score_fracture_exact_count": 0,
                    "score_fracture_miss_count": 0,
                    "played_at": "string",
                    "extra_info": "string",
                    "property1": "string",
                    "property2": "string"
                },
                "file_url": "string",
                "file_hash": "string",
                "create_time": 0
            }
        ],
        "total": 0
    }
}

🔵302

🟠400

🟠401

🟠404

🔴500

请求参数

请求示例代码

返回响应