查询活动玩家

描述

查询某个活动下获得免费次数的玩家，以及每个玩家的使用情况。

请求方式

Item	Name	Sample
Path	Path	{Api_Address}/merchant/activity/player_list
Request Method	POST

请求参数

Name	Type	Required	Description
Sign Params		Y	Api 接入规范
activity_id	string	Y	活动 ID
player_id	array	N	要查询的玩家 ID，为空则查询全部玩家
offset	int	N	分页偏移量，默认 0
limit	int	N	每页条数，默认 20，最大 200

返回参数

Name	Type	Required	Description
code	int	Y	0 表示成功
msg	string	Y	对应 code 的错误描述
total	int	Y	符合条件的玩家总数
list	array	Y	玩家列表
list[].player_id	string	Y	玩家 ID
list[].currency	string	Y	币种
list[].bet_count	int	Y	玩家已使用的免费投注次数
list[].bet_amount	string	Y	玩家免费投注累计投注金额
list[].reward_amount	string	Y	玩家免费投注累计派奖金额
list[].total_receive	int	Y	玩家累计获得的免费次数
list[].receive_time	int	Y	获得免费次数的时间，秒级 Unix 时间戳
list[].expired_time	int	Y	免费次数过期时间，秒级 Unix 时间戳
list[].unused_amount	int	Y	免费次数未使用数量
list[].revoked	int	Y	已撤销的免费次数

请求示例

Http Request
    Post Method
    URL : {Api_Address}/merchant/activity/player_list?mid=1697028447&sign=...&ts=1713768205
    Content-Type：application/json
    {"activity_id":"act_freebet456789","player_id":["p456"],"offset":0,"limit":20}

Http Response(success)
    {"code":0,"msg":"","total":1,"list":[{"player_id":"p456","currency":"PHP","bet_count":3,"bet_amount":"0.6","reward_amount":"1.5","total_receive":5,"receive_time":1750377600,"expired_time":1750895999,"unused_amount":2,"revoked":0}]}