撤销玩家免费次数
描述
撤销单个玩家未使用的免费次数，用于误发等场景。已使用的次数和已获得的奖金不受影响。
请求方式
| Item | Name | Sample |
|---|---|---|
| Path | Path | {Api_Address}/merchant/activity/player_revoke |
| Request Method | POST |
请求参数
| Name | Type | Required | Description |
|---|---|---|---|
| Sign Params | Y | Api 接入规范 | |
| request_id | string | N | 可选，服务端暂不使用 |
| activity_id | string | Y | 活动 ID |
| player_id | string | Y | 玩家 ID |
| revoke_all | bool | N | true 表示撤销全部剩余免费次数 |
| revoke_count | int | N | 撤销的次数。大于剩余次数时按全部剩余次数处理 |
返回参数
| Name | Type | Required | Description |
|---|---|---|---|
| code | int | Y | 0 表示成功 |
| msg | string | Y | 对应 code 的错误描述 |
| revoked | int | Y | 实际撤销的次数 |
请求示例
Http Request
Post Method
URL : {Api_Address}/merchant/activity/player_revoke?mid=1697028447&sign=...&ts=1713768205
Content-Type：application/json
{"activity_id":"act_freebet456789","player_id":"p456","revoke_count":2}
Http Response(success)
{"code":0,"msg":"","revoked":2}