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(50)	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."
}