游戏排行榜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}
]
}
注意事项:
- 所有API请求均需使用HTTP协议
- 仅限免费资源作者使用,付费作者需要联系我取得合作
- 使用该api必须在软件宣传页面和软件内关于页面说明AzumaStudio提供排行榜技术支持
- AzumaChiaki保留对排行榜进行编辑的权利