Action 74：Bind Players for Free Spin Reward
Function Description
- Bind Players for Free Spin Reward
- To prevent excessive API execution time, each call can process up to 50,000 players. Multiple calls can be made if needed.
- Binding is only possible during the inactive period or the activation period.
Parameter
| Parameter | Format | Mandatory | Description |
|---|---|---|---|
| action | Integer | Y | 74 |
| ts | Long | Y | Current system time |
| parent | String(50) | Y | Agent ID |
| eventId | String | Y | Event ID |
| players | String Array | Y | Player ID List (Maximum limit: 50,000 entries.) |
Example
{
"action": 74,
"ts": 1711555200000,
"parent": "testag",
"eventId": "123456",
"players": [
"player1",
"player2"
]
}Return Results
| Parameter | Format | Description |
|---|---|---|
| status | String(4) | Success: 0000 Error: See Error Codes in Appendix |
| data | JSON Array | The failed bind player ID returned data will be listed in the following table. |
| err_text | String(255) | Error messages will only appear if an error occurs. |
Data Object
| Parameter | Format | Description |
|---|---|---|
| failedBindingPlayers | Array of String | The failed bind player ID list |
| notExistedPlayers | Array of String | The non-existent player ID list |
Operation Sample
// 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. If necessary parameters are not provided or not meet requirement, for example: name, then:
{
"status": "8000",
"err_text": "The parameter of input error, please check your parameter is correct or not. parameter:event id is required"
}
2. If free spin reward event not exist, then:
{
"status": "9015",
"err_text": "Event not exist."
}
3. If free spin reward event status not allow to do this action, then:
{
"status": "9998",
"err_text": "This action cannot be executed as the event status is TERMINATED."
}