文档

测试

📉 获取积分排行榜

websocket测试

GET

/rankscore

接口描述

积分排行榜数据,最多可以获得前200名玩家数据列表

请求参数

参数名

类型

描述

必填

game_id

int

游戏ID

必填

channel_id

int

渠道ID

必填

appid

string

APPID

必填

type

int

排行榜数据类型,0是所有渠道,否则填写当前渠道号(channel_id的值)

必填

index

int

对应上报排行榜积分的index,范围为(0-4,可选参数,不填默认为0),

可选

limit

int

获取前xxx名的玩家数据,limit最多前200名

必填

响应参数

参数名

类型

描述

必填

code

int

状态码

必填

msg

string

说明

必填

data

string

返回的数据

必填

player_id

bigint

玩家ID

必填

channel_id

int

渠道ID

必填

nickName

string

用户昵称

必填

avatarUrl

string

用户头像url地址

必填

gender

int

性别 0：未知、1：男、2：女(默认0)

必填

registtime

int

玩家注册时间(时间戳)

必填

rank_score

bigint

得分榜(参与排名的积分数据)

必填

rank_score1

bigint

得分榜(参与排名的积分数据)

必填

rank_score2

bigint

得分榜(参与排名的积分数据)

必填

rank_score3

bigint

得分榜(参与排名的积分数据)

必填

rank_score4

bigint

得分榜(参与排名的积分数据)

必填

说明 / 示例

## 请求示例: ```JavaScript https://*******/rankscore?game_id=游戏ID&channel_id=渠道ID&appid=APPID&type=排行榜数据类型&limit=前xxx名的玩家&index=排行榜积分的index ``` ## 请求成功: ```language { code: 1, msg: "获取排行榜数据成功", data: [ {player_id: 2, game_id: 1, channel_id: 3, nickName: "dsdads",…}, {player_id: 4, game_id: 1, channel_id: 2, nickName: "dsdads",…} ......... ] } ``` ## 请求失败: ```language { code: -101, msg: "获取排行榜数据失败", data: [] } ``` ## 特别说明: ==index: 0 ------对应的排行榜字段是rank_score (该字段每周清空一次,可以用来做周排行榜) index: 1 ------对应的排行榜字段是rank_score1 index: 2 ------对应的排行榜字段是rank_score2 index: 3 ------对应的排行榜字段是rank_score3 index: 4 ------对应的排行榜字段是rank_score4==

上一篇 📤 上报排行榜积分

nextDoc 💾 云存档