游戏排行榜API文档

1. 提交玩家数据

接口地址

POST http://azumastudio.top/api/pub-update

请求头

字段
Content-Type application/json

请求参数(JSON格式)

字段 类型 必填 说明
name String 玩家昵称
playerId String 玩家唯一标识符
score Number 玩家积分(用于排名计算)
identifier String 排行榜唯一标识名称

示例代码

fetch({
    url: 'http://azumastudio.top/api/pub-update',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        name: "玩家昵称",
        playerId: "123456", // 玩家唯一ID
        score: 1500,         // 当前积分
        identifier: "season1" // 排行榜标识
    })
});

2. 获取完整排行榜

接口地址

GET http://azumastudio.top/api/get-pub-leaderboard

请求参数

参数 类型 必填 说明
identifier String 要查询的排行榜标识名称

响应格式

字段 类型 说明
code Number 状态码(0表示成功)
data Array 排行榜数据列表,包含name和score字段

示例响应

{
    "code": 0,
    "data": [
        {"name": "玩家A", "score": 2000},
        {"name": "玩家B", "score": 1800},
        {"name": "玩家C", "score": 1650}
    ]
}

注意事项: