免费旋转api

transfer/zh/API_release_version.md

@@ -15,3 +15,4 @@
   |1.1.10| (1) [存取款] "/api/game/withdraw"   增加请求参数 "交易的唯一标识码(traceid)"  | 2025.2.14 |
   |1.1.11| (1) [游戏大厅接入]  游戏大厅接入流程说明  | 2025.4.18 |
   |1.1.12| (1) [把玩家踢下线]  增加踢除玩家接口  | 2025.6.24 |
+  |1.1.13| (1) 增加免费活动相关的接口文档  | 2025.9.19 |

transfer/zh/_sidebar.md

@@ -19,6 +19,12 @@
    * [免费游戏剩余次数](zh/free_count)
    * [游戏大厅接入](zh/lobby)
    * [踢除玩家](zh/kickout)
+   * [免费赠送活动-创建](zh/freespin_create)
+   * [免费赠送活动-取消](zh/freespin_cancel)
+   * [免费赠送活动-添加玩家](zh/freespin_addplayer)
+   * [免费赠送活动-删除玩家](zh/freespin_delplayer)
+   * [免费赠送活动-玩家参与情况](zh/freespin_getplayerfrb)
+   * [免费赠送活动-游戏下注配置](zh/freespin_gamebetconfi)
 * [附录](zh/appendice)
    * [交易资料名称](zh/Transaction_data)
    * [货币类型列表](zh/currency)

transfer/zh/freespin_addplayer.md

@@ -0,0 +1,86 @@
+# <font >添加玩家到免费活动</font>
+## 描述
+
+> 使用此方法，运营商可以将玩家添加到现有的免费回合奖金中。 同一个活动，玩家只能参加一次。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/addplayer
+```
+
+## 哈希计算
+哈希代码通过以下步骤来计算:
+从请求 POST参数获取所有参数(预期哈希)并附加到字符串:
+- 1.按字母表顺序对所有参数排序。
+- 2.在 key1=value1&key2=value2 中附加它们(如果值不为空)
+- 3.附加密钥，即: 
+  ```
+  key1=value1&key2=value&hashkey=3m@K#9zPxL$%Yb*8C    
+  ```
+- 4.使用 MD5 计算哈希,转为全部大写。
+- 5.用"hash"为名字附加到参数中,代替hashkey字段,最终参数为:
+    ```
+    key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+- 6.如果平台与哈希参数对比失败。发送错误代码1008。
+
+
+## 请求参数
+
+ |    名称    |    类型     | 必要 |                         描述                         |
+ | :--------: | :---------: | :--: | :--------------------------------------------------: |
+ | extension1 |   string    |  Y   |                       代理账号                       |
+ |    cert    |   string    |  Y   |                       安全代码                       |
+ | bonuscode  | String(128) |  Y   |             运营商系统中的奖励唯一标识符             |
+ | playerlist |   string    |  Y   | 要添加到现有免费回合奖励的玩家ID的列表(以逗号分隔) |
+ |    hash    |   string    |  Y   |                    请求的哈希代码                    |
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/addplayer
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1:         adminweb
+    cert:               v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    bonuscode:          aaabbbccc
+    playerlist:         2515,454156,55415415,6156416,75415456,81564564
+    hash:               165BB0FEEB254154DE1AEF36E7ED48C2
+    ```
+	
+	
+## 返回结果
+
+ | 名称 |  类型  |   描述   |
+ | :--: | :----: | :------: |
+ | ret  |  int   | 状态代码 |
+ | info | string | 状态说明 |
+
+
+ ### 成功的结果
+
+```
+{
+	"ret": -1,
+	"info": "ok"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```

transfer/zh/freespin_cancel.md

@@ -0,0 +1,84 @@
+# <font >取消赠送免费活动</font>
+## 描述
+
+> 通过此方法，运营商可以取消已创建免费回合奖励活动。但已经参与的玩家，将继续完成奖励，不会受到影响。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/cancel
+```
+
+## 哈希计算
+哈希代码通过以下步骤来计算:
+从请求 POST参数获取所有参数(预期哈希)并附加到字符串:
+- 1.按字母表顺序对所有参数排序。
+- 2.在 key1=value1&key2=value2 中附加它们(如果值不为空)
+- 3.附加密钥，即: 
+  ```
+  key1=value1&key2=value&hashkey=3m@K#9zPxL$%Yb*8C    
+  ```
+- 4.使用 MD5 计算哈希,转为全部大写。
+- 5.用"hash"为名字附加到参数中,代替hashkey字段,最终参数为:
+    ```
+    key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+- 6.如果平台与哈希参数对比失败。发送错误代码1008。
+
+
+## 请求参数
+
+ |      名称      |    类型     | 必要 |                        描述                        |
+ | :------------: | :---------: | :--: | :------------------------------------------------: |
+ |   extension1   |   string    |  Y   |                      代理账号                      |
+ |      cert      |   string    |  Y   |                      安全代码                      |
+ |   bonuscode    | String(128) |  Y   |            运营商系统中的奖励唯一标识符            |
+ |      hash      |   string    |  Y   |                  请求的哈希代码                  |
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/cancel
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1: adminweb
+    cert:       v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    bonuscode:  aaabbbccc
+    hash:       3ECE2322AA1952D0A818DD1F09493B60
+    ```
+	
+	
+## 返回结果
+
+ | 名称 |  类型  |   描述   |
+ | :--: | :----: | :------: |
+ | ret  |  int   | 状态代码 |
+ | info | string | 状态说明 |
+
+
+ ### 成功的结果
+
+```
+{
+	"ret": -1,
+	"info": "ok"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```

transfer/zh/freespin_create.md

@@ -0,0 +1,114 @@
+# <font >创建赠送免费活动</font>
+## 描述
+
+> 通过此方法，运营商可以为游戏创建免费回合奖励活动。出现网络错误时，运营商可以发送重复的创建免费回合请求。如果存在奖励代码相同的有效FR奖励，则系统不会创建新的RF奖励。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/create
+```
+
+## 哈希计算
+哈希代码通过以下步骤来计算:
+从请求 POST参数获取所有参数(预期哈希)并附加到字符串:
+- 1.按字母表顺序对所有参数排序。
+- 2.在 key1=value1&key2=value2 中附加它们(如果值不为空)
+- 3.附加密钥，即: 
+  ```
+  key1=value1&key2=value&hashkey=3m@K#9zPxL$%Yb*8C    
+  ```
+- 4.使用 MD5 计算哈希,转为全部大写。
+- 5.用"hash"为名字附加到参数中,代替hashkey字段,最终参数为:
+    ```
+    key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+- 6.如果平台与哈希参数对比失败。发送错误代码1008。
+
+
+## 请求参数
+
+ |      名称      |    类型     | 必要 |                        描述                        |
+ | :------------: | :---------: | :--: | :------------------------------------------------: |
+ |   extension1   |   string    |  Y   |                      代理账号                      |
+ |      cert      |   string    |  Y   |                      安全代码                      |
+ |   bonuscode    | String(128) |  Y   |            运营商系统中的奖励唯一标识符            |
+ |     rounds     |    int32    |  Y   |                     免费回合数                     |
+ |    maxscore    |    int64    |  Y   |           玩家在本活动总能获取的分数上限           |
+ |   startdata    |    int64    |  Y   |           奖励活动参与的开始时间戳(毫秒)           |
+ |    enddata     |    int64    |  Y   |           奖励活动参与的结束时间戳(毫秒)           |
+ |  validitydata  |    int64    |  Y   |            玩家生效后的截至时间戳(毫秒)            |
+ |     games      |   string    |  Y   | json数组字符串，配置能参与的游戏，以及游戏投注信息 |
+ |   games.gid    |   string    |  Y   |                      游戏gid                       |
+ | games.betindex |    int32    |  Y   |                    游戏投注索引                    |
+ |  games.betmu   |    int32    |  Y   |                    游戏投注倍数                    |
+ |      hash      |   string    |  Y   |                  请求的哈希代码                  |
+
+
+
+
+**游戏下注配置可通过接口获取:** [获取游戏下注配置](zh/freespin_gamebetconfi)
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/create
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1:     adminweb
+    cert:           v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    bonuscode:      aaabbbccc
+    rounds:         11
+    maxscore:       1000
+    startdata:      1752042214512
+    enddata:        1752052214512
+    validitydata:   1752152214512
+    games:          [
+                        {
+                            "gid": "be001",
+                            "betindex": 0,
+                            "betmul": 1
+                        },
+                        {
+                            "gid": "be022",
+                            "betmul": 1,
+                            "betindex": 0
+                        }
+                    ]
+    hash:           3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+	
+	
+## 返回结果
+
+ | 名称 | 类型 | 描述 |
+ |:--------:|:-----:|:--------:|
+ | ret | int | 状态代码 |
+ | info | string | 状态说明 |
+
+
+ ### 成功的结果
+
+```
+{
+	"ret": -1,
+	"info": "ok"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```

transfer/zh/freespin_delplayer.md

@@ -0,0 +1,86 @@
+# <font >从免费活动删除玩家</font>
+## 描述
+
+> 使用此方法，运营商可以将玩家从现有的免费回合奖金中删除。 但已经参与的玩家，将继续完成奖励，不会受到影响。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/delplayer
+```
+
+## 哈希计算
+哈希代码通过以下步骤来计算:
+从请求 POST参数获取所有参数(预期哈希)并附加到字符串:
+- 1.按字母表顺序对所有参数排序。
+- 2.在 key1=value1&key2=value2 中附加它们(如果值不为空)
+- 3.附加密钥，即: 
+  ```
+  key1=value1&key2=value&hashkey=3m@K#9zPxL$%Yb*8C    
+  ```
+- 4.使用 MD5 计算哈希,转为全部大写。
+- 5.用"hash"为名字附加到参数中,代替hashkey字段,最终参数为:
+    ```
+    key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+- 6.如果平台与哈希参数对比失败。发送错误代码1008。
+
+
+## 请求参数
+
+ |    名称    |    类型     | 必要 |                         描述                         |
+ | :--------: | :---------: | :--: | :--------------------------------------------------: |
+ | extension1 |   string    |  Y   |                       代理账号                       |
+ |    cert    |   string    |  Y   |                       安全代码                       |
+ | bonuscode  | String(128) |  Y   |             运营商系统中的奖励唯一标识符             |
+ | playerlist |   string    |  Y   | 要添加到现有免费回合奖励的玩家ID的列表(以逗号分隔) |
+ |    hash    |   string    |  Y   |                    请求的哈希代码                    |
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/delplayer
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1:         adminweb
+    cert:               v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    bonuscode:          aaabbbccc
+    playerlist:         75415456,81564564
+    hash:               165BB0FEEB254154DE1AEF36E7ED48C2
+    ```
+	
+	
+## 返回结果
+
+ | 名称 |  类型  |   描述   |
+ | :--: | :----: | :------: |
+ | ret  |  int   | 状态代码 |
+ | info | string | 状态说明 |
+
+
+ ### 成功的结果
+
+```
+{
+	"ret": -1,
+	"info": "ok"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```

transfer/zh/freespin_gamebetconfi.md

@@ -0,0 +1,127 @@
+# <font >获取游戏下注配置</font>
+## 描述
+
+> 使用这种方法，娱乐场运营商系统可以从系统获得所有游戏的下注配置，用以创建免费赠送活动。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/gamebetconfig
+```
+
+
+
+## 请求参数
+
+ |    名称    |    类型     | 必要 |             描述             |
+ | :--------: | :---------: | :--: | :--------------------------: |
+ | extension1 |   string    |  Y   |           代理账号           |
+ |    cert    |   string    |  Y   |           安全代码           |
+
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/getplayerfrb
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1:         adminweb
+    cert:               v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    ```
+	
+	
+## 返回结果
+
+ |         名称         |  类型  |       描述       |
+ | :------------------: | :----: | :--------------: |
+ |        games         | object |   游戏配置列表   |
+ |      games.key       | string |     游戏gid      |
+ |  games.value.areaid  |  int   |      区域id      |
+ | games.value.currency | string |     货币符号     |
+ | games.value.betextra |  int   |     额外投注     |
+ |   games.value.bet    | array  | 可以下注分数列表 |
+ |  games.value.betmul  | array  | 可以下注倍数列表 |
+ | games.value.betline  | array  |  可选下注线数量  |
+
+ ### 成功的结果
+
+```
+{
+	"games": {
+		"afa001": {
+			"areaid": 1,
+			"currency": "USD",
+			"betextra": 0,
+			"bet": [
+				100,
+				500,
+				1000,
+				3000,
+				5000
+			],
+			"betline": [
+				20
+			],
+			"betmul": [
+				1,
+				2,
+				3,
+				4,
+				5,
+				6,
+				7,
+				8,
+				9,
+				10
+			]
+		},
+		"afa002": {
+			"areaid": 1,
+			"currency": "USD",
+			"betextra": 0,
+			"bet": [
+				100,
+				300,
+				1000,
+				3000,
+				5000
+			],
+			"betline": [
+				20
+			],
+			"betmul": [
+				1,
+				2,
+				3,
+				4,
+				5,
+				6,
+				7,
+				8,
+				9,
+				10
+			]
+		}
+	},
+	"code": 0,
+	"msg": "success"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```

transfer/zh/freespin_getplayerfrb.md

@@ -0,0 +1,99 @@
+# <font >获取玩家参与免费赠送活动信息</font>
+## 描述
+
+> 使用这种方法，娱乐场运营商系统可以从系统获得所有玩家能够参与的活动。
+
+> 请求方式（ Host-> BeSoft）:post 
+
+> 编码方式：application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+## 网址
+```
+{besoftapi}/api/bonus/getplayerfrb
+```
+
+## 哈希计算
+哈希代码通过以下步骤来计算:
+从请求 POST参数获取所有参数(预期哈希)并附加到字符串:
+- 1.按字母表顺序对所有参数排序。
+- 2.在 key1=value1&key2=value2 中附加它们(如果值不为空)
+- 3.附加密钥，即: 
+  ```
+  key1=value1&key2=value&hashkey=3m@K#9zPxL$%Yb*8C    
+  ```
+- 4.使用 MD5 计算哈希,转为全部大写。
+- 5.用"hash"为名字附加到参数中,代替hashkey字段,最终参数为:
+    ```
+    key1=value1&key2=value&hash=3E8ABC6949A0A0CFF9110CF1128FBE25
+    ```
+- 6.如果平台与哈希参数对比失败。发送错误代码1008。
+
+
+## 请求参数
+
+ |    名称    |    类型     | 必要 |             描述             |
+ | :--------: | :---------: | :--: | :--------------------------: |
+ | extension1 |   string    |  Y   |           代理账号           |
+ |    cert    |   string    |  Y   |           安全代码           |
+ | bonuscode  | String(128) |  Y   | 运营商系统中的奖励唯一标识符 |
+ |   userid   |    int64    |  Y   |            玩家ID            |
+ |    hash    |   string    |  Y   |        请求的哈希代码        |
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/bonus/getplayerfrb
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    extension1:         adminweb
+    cert:               v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    bonuscode:          aaabbbccc
+    userid:             81564564
+    hash:               165BB0FEEB254154DE1AEF36E7ED48C2
+    ```
+	
+	
+## 返回结果
+
+ |       名称        |  类型  |        描述        |
+ | :---------------: | :----: | :----------------: |
+ |      bonuses      | array  |      活动列表      |
+ | bonuses.currency  | string |      货币符号      |
+ | bonuses.bonuscode | string |     活动唯一ID     |
+ |  bonuses.gidlist  | string | 能够参与的游戏列表 |
+ |   bonuses.round   |  int   | 赠送的免费旋转次数 |
+ |  bonuses.enddata  | int64  |    活动结束日期    |
+
+
+ ### 成功的结果
+
+```
+{
+	"bonuses": [
+		{
+			"currency": "USD",
+			"bonuscode": "aaabbbccc",
+			"gidlist": "be001,be022,be002,afa013,afa014,afa019",
+			"round": 11,
+			"enddata": 1752052214512
+		}
+	],
+	"code": 0,
+	"msg": "success"
+}
+```
+
+
+ ### 失败的结果
+
+```
+{
+	"ret": 1008,
+	"info": "param erro"
+}
+```