# 王者荣耀排行榜
# 简介
根据平台要求,中台这边提供了根据主播平台uid来查询对应的榜单数据。
# 案例展示
# 接入
测试域名:https://apitest.livelink.qq.com 正式域名:https://welive.qq.com
# http请求: POST
请求链接: https://${环境域名}/api/gamedata/pull?id=xx&tm=1569479430&nonce=12345&sign=b353697003d86418db35f0ce239e7d20794b5551
# 公共参数(GET)
参数 | 类型 | 描述 |
---|---|---|
id | string | 请求发起方的身份标识(如huya、douyu) |
nonce | string | 随机数 |
tm | int64 | 秒级时间戳 |
sign | string | 签名 |
计算方式: sign=sha1($id$nonce$secret$tm),注意,加密前的原文是按变量名首字母的字母序拼接而成。
# 私有参数(POST)
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
plat_id | string | 是 | 平台id:huya/douyu/egame |
plat_uid | string | 是 | 平台用户uid |
user_type | int | 是 | 用户类型:1-主播 2-用户 |
game_code | string | 游戏代码 | 是 |
event_time | string | 事件时间 | 是 |
path | string | 数据对应请求路径 | 是 |
data | array | 具体数据请求所需参数 | 是 |
# 数据接口描述
# 大神榜数据拉取(全区排行)
{
"plat_id": "huya", // 必填
"plat_uid": "2386516066", // 必填 平台用户/主播ID
"user_type": 1, // 必填1主播 2用户
"game_code": "yxzj",// 必填
"event_time": "2020-11-16 01:02:15",// 必填
"path": "/leaderboard/yxzj/dashenbang", // 必填需要的数据对应路径,数据提供方会提供
"data": {"hero_id" : "120"} // 必填 不同请求自定义参数,数据提供方会提供
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
{
"data": [{
"OpenId": "4ec68d0e94c6841f52530dda0b7900f0",
"AcntName": "1giao一",
"EquipStr": "1524,1422,1327,1347,1334,1338",
"GameCnt": "492",
"PvpLevel": "30",
"RankGrade": "16",
"RankNo": "82",
"RankScore": "32",
"Score": "6376",
"SymbolStr": "1512,1512,1512,1512,1512,1512,1512,1512,1512,1512,2515,2515,2515,2515,2515,2515,2515,2515,2515,2515,3509,3509,3509,3509,3509,3509,3509,3509,3509,3509",
"VipLevel": "6",
"VipScore": "10130",
"WinCnt": "299",
"iArea": "4",
"iPartition": "94",
"plat_uid": "2386516066"
"fighting":"1400"
}],
"msg": "ok",
"ret": 0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 返回值说明
参数 | 描述 |
---|---|
OpenId | 玩家id |
AcntName | 玩家名字 |
PvpLevel | 玩家等级 |
VipLevel | 玩家VIP等级 |
VipScore | 玩家VIP积分 |
RankGrade | 玩家排位赛段位 |
RankScore | 玩家排位赛积分 |
RankNo | 大神排名 |
Score | 大神分数 |
WinCnt | 胜场数 |
GameCnt | 比赛场数 |
EquipStr | 装备字符串 |
SymbolStr | 符文字符串 |
plat_uid | 主播id |
iArea | 大区(手Q安卓(1)、手Qios(2)、微信安卓(3)、微信ios(4) |
iPartition | 服务器区号 (登陆界面的服务器号) |
fighting | 英雄战力 |
# 巅峰榜(单层级)-单用户接口
{
"plat_id": "huya", // 必填
"plat_uid": "2182577519", // 必填 平台用户/主播ID
"user_type": 1, // 必填 1主播 2用户
"game_code": "yxzj",// 必填
"event_time": "2020-11-16 01:02:15",// 必填
"path": "/leaderboard/yxzj/dianfengbang", // 必填 需要的数据对应路径,数据提供方会提供
"data": {"area" : "1"} // 必填 area : 1-全国
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
{
"data": [{
"OpenId": "4ec68d0e94c6841f52530dda0b7900f0",
"PlayerName": "寂寞瓶子小拒",
"PvpLevel": "30",
"RankNo": "72",
"RankScore": "2205",
"ScoreOfRank": "0",
"ShowGradeOfRank": "0",
"iArea": "4",
"iPartition": "94",
"plat_uid": "2182577519"
}, {
"OpenId": "4ec68d0e94c6841f52530dda0b7900f0",
"PlayerName": "司马云空66",
"PvpLevel": "30",
"RankNo": "36",
"RankScore": "2351",
"ScoreOfRank": "0",
"ShowGradeOfRank": "0",
"iArea": "2",
"iPartition": "85",
"plat_uid": "2182577519"
}],
"msg": "ok",
"ret": 0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 返回值说明
参数 | 描述 |
---|---|
OpenId | 玩家id |
RankNo | 玩家排名 |
RankScore | 分数 |
PvpLevel | 玩家等级 |
PlayerName | 玩家角色名 |
ShowGradeOfRank | 表现段位 |
ScoreOfRank | 星星数 |
plat_uid | 主播id |
iArea | 大区(手Q安卓(1)、手Qios(2)、微信安卓(3)、微信ios(4) |
iPartition | 服务器区号 (登陆界面的服务器号) |
# 荣耀榜数据拉取(各地区/全国 排行)
{
"plat_id": "huya", // 必填
"plat_uid": "1680925919", // 必填 平台用户/主播ID
"user_type": 1, // 必填 1主播 2用户
"game_code": "yxzj",// 必填
"event_time": "2020-11-16 01:02:15",// 必填
"path": "/leaderboard/yxzj/rongyaobang", // 必填 需要的数据对应路径,数据提供方会提供
"data": {"hero_id": "139"} // 必填 hero_id : 英雄id
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
{
"data": [{
"OpenId": "4ec68d0e94c6841f52530dda0b7900f0",
"RankDetail": [{
"Rank": "1",
"adcode": "诸暨市-- 县排名(周)",
"adId": "330681",
"subRankType": 1
}, {
"Rank": "1",
"adcode": "绍兴市-- 市排名(周)",
"adId": "330681",
"subRankType": 2
}, {
"Rank": "1",
"adcode": "浙江省-- 省排名(周)",
"adId": "330681",
"subRankType": 3
}, {
"Rank": "2",
"adcode": "国服排名(周)",
"adId": "330681",
"subRankType": 4
}, {
"Rank": "2",
"adcode": "国服排名(月)",
"adId": "330681",
"subRankType": 5
}],
"hero_id": "139",
"iArea": "2",
"iPartition": "2024",
"plat_uid": "1680925919",
"AcntName": "1giao一",
"fighting":"1400" ,
"rankName":"最强王者" ,
}],
"msg": "ok",
"ret": 0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# 返回值说明
参数 | 描述 |
---|---|
Rank | 玩家排名 |
adcode | 地区 |
adId | 地区id |
subRankType | 排行榜类型 0无排名,1县排名(周),2市排名(周),3省排名(周),4国家排名(荣耀战力用作国级月榜),5国家排名(荣耀战力用作国级周榜) |
hero_id | 英雄id |
plat_uid | 主播id |
iArea | 大区(手Q安卓(1)、手Qios(2)、微信安卓(3)、微信ios(4) |
iPartition | 服务器区号 (登陆界面的服务器号) |
OpenId | 玩家id |
AcntName | 角色名称 |
fighting | 战力 |
rankName | 段位 |
# 巅峰榜(地域级)-列表接口
{
"plat_id": "huya", // 必填
"plat_uid": "", // 必填 传1即可
"user_type": 1, // 必填 传1即可
"game_code": "yxzj", // 必填
"event_time": "2020-11-16 01:02:15", // 必填
"path": "/leaderboard/yxzj/fightingRank", // 必填 需要的数据对应路径,数据提供方会提供
"data": {
"scene": "act_6084", // 必填 授权场景
"area": "1", // 必填 游戏大区 1手Q安卓 2手QiOS 3微信安卓 4微信iOS
"page": "1", // 选填,默认1
"image": "0" // 选填,默认0 0实时 1最近一次周期结算时定榜数据
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"data":[
{
"uid":"",
"adcode":440115,
"headurl":"http://thirdqq.qlogo.cn/ek_qqthird/AQEpuuBILBINNvRDKFMeT64ibET0Eb0MWSnOUGZr4h6XImwjkwBL6AHgvWDodz9Kq6rNeDOX1fedXkZVQmfH6CtPOibnXVJWZ6p56HF1kCT0lmeeGpthY",
"hiderank":0,
"logicworldId":1257,
"playerName":"生一何己",
"rankno":84,
"targetvalue":2450
},
{
"uid":"xxxyyy",
"adcode":360802,
"headurl":"http://thirdqq.qlogo.cn/qqapp/1104466820/62D55EF888B32899C44980778BC0A953",
"hiderank":0,
"logicworldId":1304,
"playerName":"小鳄鱼星宇",
"rankno":26,
"targetvalue":2489
}
],
"ret":0,
"msg":"ok",
"tid":"309692620844577682"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 返回值说明
参数 | 描述 |
---|---|
playerName | 玩家昵称 |
rankNo | 游戏排名 |
targetvalue | 分数 |
adcode | 行政区域 |
uid | 主播、平台用户id |
headUrl | 头像 |
logicworldId | 玩家区服 |
hiderank | 1为隐藏榜单 |
# 英雄榜(地域级)-列表接口
{
"plat_id": "huya", // 必填
"plat_uid": "", // 必填 传1即可
"user_type": 1, // 必填 传1即可
"game_code": "yxzj", // 必填
"event_time": "2020-11-16 01:02:15", // 必填
"path": "/leaderboard/yxzj/heroRank", // 必填 需要的数据对应路径,数据提供方会提供
"data": {
"scene": "act_6084", // 必填 授权场景
"area": "1", // 必填 游戏大区 1手Q安卓 2手QiOS 3微信安卓 4微信iOS
"page": "1", // 选填,默认1
"image": "0", // 选填,默认0 0实时 1最近一次周期结算时定榜数据
"heroId": "163" // 必填 英雄id
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"data":[
{
"uid": "3x6pjf69vhaq99g",
"adcode": 330702,
"headurl": "http://thirdqq.qlogo.cn/ek_qqapp/AQAAHez1XSjkEmo6QK0zYyabIQfCjr9PCSXMIHoe7zng1604icDfTOjPSbYiapXGia3C65Y4uvuYI3ABpWib3JI0gtM1ica9icdJgFpicia5XPX4yCZz0mEsHfg",
"hiderank": 0,
"logicworldId": 1171,
"playerName": "亚特兰蒂斯坦",
"rankno": 61,
"targetvalue": 2368
},
{
"uid":"xxxyyy",
"adcode":360802,
"headurl":"http://thirdqq.qlogo.cn/qqapp/1104466820/62D55EF888B32899C44980778BC0A953",
"hiderank":0,
"logicworldId":1304,
"playerName":"小鳄鱼星宇",
"rankno":26,
"targetvalue":2489
}
],
"ret":0,
"msg":"ok",
"tid":"309692620844577682"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 返回值说明
参数 | 描述 |
---|---|
playerName | 玩家昵称 |
rankNo | 游戏排名 |
targetvalue | 分数 |
adcode | 行政区域 |
uid | 主播、平台用户id |
headUrl | 头像 |
logicworldId | 玩家区服 |
hiderank | 1为隐藏榜单 |