# <font >Freespin Create</font>
## Description

> By using this method, the entertainment venue operator system can obtain all the activities that players can participate in from the system.

> Request method:（ Host-> BeSoft）:post 

> Encoding method：application/x-www-form-urlencoded

> Besoft The response data format is: application/json

##  Method URL
```
{besoftapi}/api/bonus/getplayerfrb
```

## Hash computation
Hash code is calculated through the following steps:
Obtain all parameters (expected hash) from the request POST parameters and append them to the string:
- 1. Sort all parameters in alphabetical order.
- 2. Append them in key1=value1&key2=value2 (if the values are not empty)
- 3. Additional key, namely:
```
key1=value1&key2=value&hashkey=djds83h^&*j3u5j32
```
- 4. Calculate the hash using MD5 and convert it to all uppercase letters.
- 5. Append the name "hash" to the parameter instead of the hashkey field. The final parameter is:
```
key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
```
- 6. If the comparison between the platform and the hash parameter fails. Send error code 1008.

##  Request Parameters

 |      Name      |    Type     | Required |                    Description                     |
 | :--------: | :---------: | :--: | :--------------------------: |
 | extension1 |   string    |  Y   |           Agent account             |
 |    cert    |   string    |  Y   |           Security code            |
 | bonuscode  | String(128) |  Y   |  The unique reward identifier in the operator system  |
 |   userid   |    int64    |  Y   |            user id            |
 |    hash    |   string    |  Y   |        The requested hash code        |


## Example
- URL:
    - http://127.0.0.1:8000/api/bonus/getplayerfrb
- HTTP Method
    -   POST
- Form Data
    > Content-Type: application/x-www-form-urlencoded
    ``` 
    extension1:         adminweb
    cert:               v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
    bonuscode:          aaabbbccc
    userid:             81564564
    hash:               165BB0FEEB254154DE1AEF36E7ED48C2
    ```
	
	
## Return Result

 | Name | Type| Description |
 | :---------------: | :----: | :----------------: |
 |      bonuses      | array  |      Activity list      |
 | bonuses.currency  | string |     Currency symbol     |
 | bonuses.bonuscode | string |     Unique ID for the event     |
 |  bonuses.gidlist  | string | A list of games that can be participated in |
 |   bonuses.round   |  int   | Free spins given as a gift |
 |  bonuses.enddata  | int64  |    End date of the event    |


 ##  Successful Result

```
{
	"bonuses": [
		{
			"currency": "USD",
			"bonuscode": "aaabbbccc",
			"gidlist": "be001,be022,be002,afa013,afa014,afa019",
			"round": 11,
			"enddata": 1752052214512
		}
	],
	"code": 0,
	"msg": "success"
}
```


 ## Failed Result

```
{
	"ret": 1008,
	"info": "param erro"
}
```