Action 74：绑定玩家到免费场次
功能说明
- 绑定玩家到免费场次
- 为防止 API 执行时间过长，每次调用最多处理 50,000 个玩家账号，可进行多次调用
- 免费场次未启用或启用期间才可以绑定
参数
| 参数 | 格式 | 强制 | 说明 |
|---|---|---|---|
| action | Integer | Y | 74 |
| ts | Long | Y | 当前系统时间 |
| parent | String(50) | Y | 代理账号 |
| eventId | String | Y | 免费场次识别代号 |
| players | String Array | Y | 玩家账号数组 (最多 50,000 个) |
Example
{
"action": 74,
"ts": 1711555200000,
"parent": "testag",
"eventId": "123456",
"players": [
"player1",
"player2"
]
}返回结果
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功：0000 错误：参照附录 错误代码 |
| data | JSON Object | 回传的数据将列于下列表中 |
| err_text | String(255) | 错误讯息只会在发生错误时出现 |
Data 对象
| 参数 | 格式 | 说明 |
|---|---|---|
| failedBindingPlayers | Array of String | 绑定失败玩家列表 |
| notExistedPlayers | Array of String | 不存在的玩家列表 |
操作范例
// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
// Http Response (success)
{
"status": "0000",
"data": {
"failedBindingPlayers": [
"failed1", "failed2"
],
"notExistedPlayers": [
"not_exist1", "not_exist2",
]
}
}
// Http Response (failed)
1. 若输入参数有误，我方会回传：
{
"status": "8000",
"err_text": "The parameter of input error, please check your parameter is correct or not. parameter:event id is required"
}
2. 若免费场次不存在，我方会回传：
{
"status": "9015",
"err_text": "Event not exist."
}
3. 若免费场次不允许此操作，我方会回传：
{
"status": "9998",
"err_text": "This action cannot be executed as the event status is TERMINATED."
}