QQ游戏开放平台

文档面向读者

需要使用大玩咖信息获取接口的游戏后台开发人员

接口列表

接口分类	接口功能说明	接口名称
后台接口	获取大玩咖相关信息	/v3/user/get_dawanka_info
后台接口	上报使用付费加赠行为	/v3/user/report_dawanka_pay

接口说明

/v3/user/get_dawanka_info接口

(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) 私有参数

参数名称

类型

参数含义

version

int

传2说明：使用v2版本大玩咖数据，包含潜力咖、准玩咖，必须传递

其他或不传：使用v1版本数据，只有大玩咖和超级大玩咖

(7) 返回参数

Json格式

参数名称	类型	参数含义
ret	int	0:成功，其他:失败
msg	string	错误说明
score	int	大玩咖分值
level	int	0 :非大玩咖，1:大玩咖，2:超级大玩咖，3:潜力咖 4:准玩咖
binding	bool	是否被超级大玩咖绑定且在有效期内
discount	int	充值返利数量，百分比。例如，20代表20%
payReturnCount	int	剩余付费加赠次数。-1代表不限次
isUsingCard	bool	是否使用了特权体验卡
realLevel	int	isUsingCard=true时，返回玩家的实际等级
CardExpireTs	Int64	使用特权卡时，返回过期时间戳（秒）

（7.1）接口示例：

https://openapi.minigame.qq.com/v3/user/get_dawanka_info?version=2&appid=1110766236&openid=AB055EE03EE6F7CCB31F6CCE75A50A38&openkey=CC11B9096D458AEFDEF72981AE5A136D&pf=qqgame&sig=d%2FbuL2nBTNKcHlj7RDChivIh1zk%3D

（7.2）接口返回

JSON示例:

{"ret":0,"msg":"","score":0,"level":0,"binding":false,"discount":0,"payReturnCount":0}

report_dawanka_pay接口

(1) 功能说明：

充值成功后，如果使用了充值加赠，则调用此接口上报玩家的使用行为，自动减少玩家的可用次数。每次上报成功，可用次数减一。利用get_dawanka_info接口的payReturnCount先判断是否有可用次数。目前仅支持pf=qqgame的请求。