上传游玩记录

POST

/api/v2/records

action=upload。请求体为客户端用公钥加密后的原始二进制（Content-Type: application/octet-stream，无任何表单包装）；服务端用本地 RSA 私钥解密，校验 ASAR 结构（meta / hit-objects / input-trace）并将后两者 zstd 解压，全部通过后才写库，避免无效输入留下残留对象或行。解密后的明文记录存入 R2 并作为 file_url 返回，file_hash 为该明文文件的 SHA-512。任何校验失败（无法解密、结构缺失、解压失败）均返回 422「未通过检验，可疑伪造内容」。每个「用户 × 谱面」在云端最多保留 4 条：按 score 从高到低、created_at 从新到旧排序，超出部分及其 R2 对象会被自动删除；若请求既未带 chartId、记录 meta 中也没有 chart_hash，则无法定位谱面，此时跳过裁剪（不会误删该用户其他谱面的记录）。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Query 参数

Body 参数application/octet-stream必填

未设置

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

上传成功。返回 { message, id, file_url?, file_hash? }（上传后记录进入审核/裁剪逻辑，列表可能延后最多 60 秒可见）。

Bodyapplication/json

示例

{
    "data": {
        "id": 0
    }
}

🟠400

🟠401

🟠422

🔴500

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

获取游玩记录

获取资源包列表/详情或下载资源包