萌宠消不停游戏API(多游戏版)

所有API端点均需在路径中包含游戏名 {game},例如 /api/game1/create

游戏名说明: 游戏名由后端配置决定(如 game1game2 等),请替换为实际使用的游戏标识。

POST /api/{game}/create

创建用户(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

POST /api/{game}/update

修改用户(支持部分字段更新,只传入需要修改的字段)

请求体示例(只更新gold和nickName):

{
    "uid": 10086,
    "gold": 8000,
    "nickName": "新名字"
}

示例请求: POST http://localhost:8000/api/game1/update

GET /api/{game}/user/<int:uid>

查询指定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"
    }
}

GET /api/{game}/Get

获取排行榜前100名,支持按等级或年级排序

参数: sort_by 可选 levelgrade,默认 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