上传成绩

POST

/api/v2/scores

上传一次游玩成绩（action=upload）。请求体需包含 chartId（谱面 ID）、score（分数）与 acc（准确率）。需要 JWT 鉴权（Authorization 头）。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Query 参数

Body 参数application/json必填

示例

{
    "chartId": "string",
    "score": 0,
    "acc": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/scores?action=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "chartId": "string",
    "score": 0,
    "acc": 0
}'

返回响应

🟢201

成绩上传成功。

该响应没有 Body

🟠400

🟠401

🟠403

🔴500

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

获取成绩

获取游玩记录