当前为2.0版本。官方API后端仅供内部使用！
©2026 P.C.T.G All Rights Reserved.
排行存档：创建存档
POST
http://127.0.0.1:8000/api/leaderboard/upload
最后修改时间：2026-07-20 08:15:02
责任人：张工
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Body 参数application/json必填
示例
{
"username": "小明",
"records": [
{
"game_id": "local_1721452800000",
"mode": "unlimited",
"difficulty": "easy",
"status": "won",
"rounds": 4,
"timestamp": 1721452800000
},
{
"game_id": "local_1721539200000",
"mode": "unlimited",
"difficulty": "easy",
"status": "lost",
"rounds": 16,
"timestamp": 1721539200000
},
{
"game_id": "daily_2026-07-20",
"mode": "daily",
"difficulty": "medium",
"status": "won",
"rounds": 6,
"timestamp": 1721625600000
}
]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://127.0.0.1:8000/api/leaderboard/upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "小明",
"records": [
{
"game_id": "local_1721452800000",
"mode": "unlimited",
"difficulty": "easy",
"status": "won",
"rounds": 4,
"timestamp": 1721452800000
},
{
"game_id": "local_1721539200000",
"mode": "unlimited",
"difficulty": "easy",
"status": "lost",
"rounds": 16,
"timestamp": 1721539200000
},
{
"game_id": "daily_2026-07-20",
"mode": "daily",
"difficulty": "medium",
"status": "won",
"rounds": 6,
"timestamp": 1721625600000
}
]
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"code": 200,
"status": "success",
"user_id": "TVVMKK3G",
"username": "小明",
"ip_location": "内网/保留地址",
"message": "存档创建成功！",
"stats": {
"easy": {
"total": 2,
"won": 1,
"win_rate": 0.5,
"avg_rounds": 4.0
},
"medium": {
"total": 1,
"won": 1,
"win_rate": 1.0,
"avg_rounds": 6.0
},
"hard": {
"total": 0,
"won": 0,
"win_rate": 0,
"avg_rounds": 0
}
}
}🟠401未认证
🟠403无权限
🟠400请求内容未预期
🟠422请求体有误
🟠405方法不许可
🔴500内部错误
修改于 2026-07-20 08:15:02