Freeze free spins - VA Docs

Freezes the specified member’s grants in this event. eventID, channelID and memberAccount are required; grantID is optional.
With grantID: freezes only that grant (it must belong to both the eventID and the memberAccount).
Without grantID: freezes all of the member’s freezable (New/Active) grants in this event.

Path

POST {host}/vendor/v2.0/freespin/freeze

Headers

Field	Type	Required	Description
`Authorization`	string	Yes	Token we provide
`Content-Type`	string	Yes	`multipart/form-data`

Request parameters

Field	Type	Required	Signed	Description
`eventID`	string	Yes	✓	Event ID (24-character hex)
`channelID`	number	Yes	✓	Channel ID (use 1 if you have no channels)
`memberAccount`	string	Yes	✓	Member account (allowed characters: `a-z A-Z 0-9 _-`)
`grantID`	string	No	✓	Grant ID (24-character hex)
`sign`	string	Yes		Signature. See Signature for how to generate it

Response

Success (the HTTP status code is always 200; check status.code for the result)

Field	Type	Description
`data`	object
`data.frozenGrants`	string[]	IDs of the frozen grants
`status`	object	Response status. See Response format

Response example

{
  "data": {
    "frozenGrants": [
      "abccc1234567890aaaaa1254",
      "abccc1234567890aaaaa1231",
      "abccc1234567890aaaaa1299",
      "abccc1234567890aaaaa1288",
      "abccc1234567890aaaaa1277"
    ]
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

Response codes

Besides the common codes, this API may also return:

Code	Description
`416`	Event not found
`418`	Member is not in the event
`429`	Too many requests