文档面向读者
需要使用大玩咖信息获取接口的游戏后台开发人员
接口说明
(1) 功能说明:
获取登录用户的大玩咖相关的信息,分值,是否是被绑定用户,充值返利数量等。目前仅支持pf=qqgame的请求。
(2) 访问域名:
openapi.minigame.qq.com
(3) http请求方式:
get
(4) 接口名称:
/v3/user/get_dawanka_info
(5) 公共参数
发送请求时,必须传入公共参数,参考说明:
https://open.qqgame.qq.com/wiki/24/35/46/47/47.html
(6) 私有参数
无。
(7) 返回参数
Json格式
参数名称 |
类型 |
参数含义 |
ret |
int |
0:成功,其他:失败 |
msg |
string |
错误说明 |
score |
int |
大玩咖分值 |
level |
int |
0 :非大玩咖 1:大玩咖 2:超级大玩咖 |
binding |
bool |
是否被超级大玩咖绑定且在有效期内 |
discount |
int |
充值返利数量,百分比。例如,20代表20% |
1. 接口示例:
https://openapi.minigame.qq.com/v3/user/get_dawanka_info?appid=1110766236&openid=AB055EE03EE6F7CCB31F6CCE75A50A38&openkey=CC11B9096D458AEFDEF72981AE5A136D&pf=qqgame&sig=d%2FbuL2nBTNKcHlj7RDChivIh1zk%3D
2. 接口返回
JSON示例:
{"ret":0,"msg":"","score":0,"level":0,"binding":false,"discount":0}
3. 返回码说明
错误码 |
描述 |
2000001 |
appid 无效 |
2000002 |
openid 无效 |
2000003 |
openkey 长度不是32字节 |
2000004 |
sig无效 |
2000005 |
token type 不对 |
2000006 |
sig 生成错误 |
2000007 |
认证调用失败 |
2000020 |
认证 appid 不合法 |
2000021 |
认证 opnenid 不合法 |
2000022 |
认证 openkey 不合法 |
2000023 |
认证 openid/openkey 失败 |
2000024 |
认证 sig 失败 |
2000025 |
其他认证错误 |
2000030 |
后端调用错误 |