所有API端点均需在路径中包含游戏名 {game},例如 /api/game1/create。
game1、game2 等),请替换为实际使用的游戏标识。
创建用户(uid必须唯一)
请求体示例:
{
"uid": 10086,
"gold": 7000,
"UserData": {
"nickName": "7000",
"UserAvatarUrl": "TEXT"
},
"LastTime": null,
"Level": 1,
"Grade": 0,
"nickName": "玩家名",
"UserAvatarUrl": "头像URL"
}
示例请求: POST http://localhost:8000/api/game1/create
修改用户(支持部分字段更新,只传入需要修改的字段)
请求体示例(只更新gold和nickName):
{
"uid": 10086,
"gold": 8000,
"nickName": "新名字"
}
示例请求: POST http://localhost:8000/api/game1/update
查询指定UID的完整用户数据
示例请求: GET http://localhost:8000/api/game1/user/10086
返回示例:
{
"success": true,
"message": "查询成功",
"data": {
"uid": 10086,
"gold": 7000,
"UserData": {...},
"LastTime": null,
"Level": 1,
"Grade": 0,
"nickName": "玩家名",
"UserAvatarUrl": "头像URL"
}
}
获取排行榜前100名,支持按等级或年级排序
参数: sort_by 可选 level 或 grade,默认 level
示例请求(按等级排序): GET http://localhost:8000/api/game1/Get?sort_by=level
返回示例:
{
"success": true,
"message": "查询成功",
"data": [
{
"uid": 10086,
"nickName": "玩家名",
"UserAvatarUrl": "头像URL",
"level": 10
},
{
"uid": 10087,
"nickName": "另一玩家",
"UserAvatarUrl": "头像URL",
"level": 9
}
]
}
按年级排序示例: GET http://localhost:8000/api/game1/Get?sort_by=grade,返回字段中的 grade 替换 level。