# 王者荣耀排行榜

# 简介

根据平台要求,中台这边提供了根据主播平台uid来查询对应的榜单数据。

# 案例展示

image-act-by-user

# 接入

测试域名: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
{
	"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

# 返回值说明

参数 描述
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
{
	"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

# 返回值说明

参数 描述
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
{
	"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

# 返回值说明

参数 描述
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
{
    "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

# 返回值说明

参数 描述
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
{
    "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

# 返回值说明

参数 描述
playerName 玩家昵称
rankNo 游戏排名
targetvalue 分数
adcode 行政区域
uid 主播、平台用户id
headUrl 头像
logicworldId 玩家区服
hiderank 1为隐藏榜单
lastUpdate: 8/21/2024, 3:33:02 PM