فهرست منبع

新增玩家交易记录文档

qingjie 8 ماه پیش
والد
کامیت
3ef2038646

+ 2 - 1
transfer/en/API_release_version.md

@@ -9,4 +9,5 @@
 |1.1.4| (1) [ Get transaction record] The type of the "inserttime" field returned by the API api/game/getgameinfo should be changed from string to int64, which is the timestamp type.<br>(2)[Get Balance Operation Log By Time][Get Transactions By Last Update Date][Get Balance Operation Log] The "createdate" field returned by the API /game/getbalanceoperationLog should be changed from string to int64 timestamp type. | 2024.11.27 |
   |1.1.5| [ Get transaction record] api/game/getgameinfo interface added parameters: "spjpbet"  | 2024.11.27 |
   |1.1.6| [ Withdraw] api/game/withdraw interface delete return value: "beforespreaderscore","afterspreaderscore"  | 2024.12.09 |
-  |1.1.7| [ Get transaction record] api/game/getgameinfo interface return value: "spjpbet". Instead of keeping two decimal places, keep four decimal places  | 2024.12.10 |
+  |1.1.7| [ Get transaction record] api/game/getgameinfo interface return value: "spjpbet". Instead of keeping two decimal places, keep four decimal places  | 2024.12.10 |
+  |1.1.8| ADD:  [Get User Balance Transaction Records] /api/game/usertradeinfo  | 2025.2.6 |

+ 1 - 3
transfer/en/_sidebar.md

@@ -13,9 +13,7 @@
    * [Get gamelist](en/game_list)
    * [Get Balance](en/Check_Balance)
    * [Withdraw](en/bet)
-   * [Get Balance Operation Log](en/result1)
-   * [Get Balance Operation Log By Time](en/His_time)
-   * [Get Transactions By Last Update Date ](en/Recode)
+   * [Get user balance transaction records](en/usertradeinfo)
    * [Get transaction record](en/game_bet_list)
    * [Get player total profit](en/total_profit_or_loss)
    * [Get round detail](en/round_detail)

+ 96 - 0
transfer/en/usertradeinfo.md

@@ -0,0 +1,96 @@
+#   <font >Get User Balance Transaction Records</font>
+##  Description
+>   This function allows Operator to query previous balance operation for target player via transaction code. This is to query and understand if previous transaction is successfully updated.
+
+> Request method:( Host-> BeSoft):post 
+
+> Encoding method:application/x-www-form-urlencoded
+
+> Besoft The response data format is: application/json
+
+##  Method URL
+> {besoftapi}/api/game/usertradeinfo
+
+##  Request Parameters
+
+|Name	|  Type   | Required    |	Description |
+|--------|-----|--------|--------|
+|cert|          String     |Y|	        security code|
+|extension1|	String     |Y|	        agent Id|
+| user       | String | Y    | player account queried                                                         |
+|startdate|     String     |Y|	        Need to convert datetime to long  format. 1517265756000 : 2018/01/30 06:42:36(GMT+8)Start date and time|
+|enddate|       String     |Y|	        Need to convert datetime to long  format. 1517265756000 : 2018/01/30 06:42:36(GMT+8)End date and time|
+|page|          Int32      |N|	        start from 0 |
+|pagesize|	    Int32      |N|	        maximum 2000
+
+
+## Example
+- URL:
+    - http://127.0.0.1:8000/api/game/usertradeinfo
+- HTTP Method
+    -   POST
+- Form Data
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    cert:v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    extension1:adminweb
+    user:Guest492
+    startdate:1700122818110
+    enddate:1700123037718
+    page:0
+    pagesize:20
+    ```
+	
+	
+##  Return Result
+
+|Nmae|	Type    |	Description    |
+|--------|----------|--------|
+|status|            Int32           |status code|
+|totalsize|         Int32           |total transactions in query result|
+|result|            array           |Result data array|
+|result.user|       string          |Player account|
+|result.sellbuy|    double          |1. Transfer score to player  , 2. Transfer score from player|
+|result.createdate| Int64           |TimeStamp of data addition (MS)|
+|result.extension1| string          |Agent account|
+
+
+## Successful  Result
+
+
+```
+
+{
+    "status": 1,
+    "totalsize": 2,
+    "result": [
+        {
+            "user": "test1",
+            "extension1": "admin",
+            "sellbuy": "2",
+            "tradescore": "10.00",
+            "createdate": 1732500566495
+        },
+        {
+            "user": "test1",
+            "extension1": "admin",
+            "sellbuy": "1",
+            "tradescore": "10.00",
+            "createdate": 1732500566495
+        }
+    ]
+}
+
+```
+##  Failed Result
+```
+{"status":1, "totalsize": 0,"result":[]}
+```
+
+##   Failed Result
+
+```
+{
+"status": 0
+}
+```

+ 1 - 0
transfer/zh/API_release_version.md

@@ -10,3 +10,4 @@
  | 1.1.5 | (1)[获得游戏下注记录] api/game/getgameinfo 增加参数 "spjpbet" | 2024.11.27 |
 | 1.1.6 | (1)[存取款] api/game/withdraw 删除参数"beforespreaderscore","afterspreaderscore" | 2024.12.09 |
 | 1.1.7 | (1)[获得下注记录] "/api/game/getgameinfo"  返回值"spjpbet"由保留两位小数改为保留四位小数  | 2024.12.10 |
+  |1.1.8| (1) 新增接口: [获得交易记录] "/api/game/usertradeinfo"  | 2025.2.6 |

+ 1 - 3
transfer/zh/_sidebar.md

@@ -12,9 +12,7 @@
    * [获取游戏列表](zh/game_list)
    * [查询余额](zh/Check_Balance)
    * [存取款](zh/bet)
-   * [余额操作记录-玩家](zh/result1)
-   * [余额操作记录-时间](zh/His_time)
-   *  [获得交易记录 ](zh/Recode)
+   *  [获得交易记录 ](zh/usertradeinfo)
    * [获得下注游戏记录](zh/game_bet_list)
    * [玩家总输赢](zh/total_profit_or_loss)
    * [游戏细单](zh/round_detail)

+ 96 - 0
transfer/zh/usertradeinfo.md

@@ -0,0 +1,96 @@
+#   <font >获得交易记录</font>
+##  描述
+>   此功能允许运营商通过交易代码查询目标玩家的先前余额操作。 这是查询并了解先前的事务是否已成功更新
+
+> 请求方式( Host-> BeSoft):post 
+
+> 编码方式:application/x-www-form-urlencoded
+
+> Besoft响应的数据格式是: application/json
+
+##  网址
+>   {besoftapi}/api/game/usertradeinfo
+
+##  请求参数
+
+| 名称       | 类型   | 必要 | 描述                                                                     |
+| ---------- | ------ | ---- | ------------------------------------------------------------------------ |
+| cert       | String | Y    | 安全代码                                                                 |
+| extension1 | String | Y    | 代理 ID                                                                  |
+| user       | String | Y    | 所查询的玩家账号                                                         |
+| startdate  | String | Y    | 开始时间戳(毫秒); 1517265756000 : 2018/01/30 06:42:36(GMT+8)起始时间日期 |
+| enddate    | String | Y    | 结束时间戳(毫秒); 1517265756000 : 2018/01/30 06:42:36(GMT+8)结束时间日期 |
+| page       | Int32  | N    | 资料页码, 从 0 开始                                                      |
+| pagesize   | Int32  | N    | 最大值 1000                                                              |
+
+
+## 示例
+- URL:
+    - http://127.0.0.1:8000/api/game/usertradeinfo
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    cert:v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    extension1:adminweb
+    user:Guest492
+    startdate:1700122818110
+    enddate:1700123037718
+    page:0
+    pagesize:20
+    ```
+	
+	
+##  返回结果
+
+|名称|	类型    |	描述    |
+|--------|----------|--------|
+|status|            Int32           |状态代码|
+|totalsize|         Int32           |本次查询总笔数|
+|result|            array           |结果数据数组|
+|result.user|       string          |玩家账号|
+|result.sellbuy|    double          |1-是向玩家转入分数  ,  2-是玩家转出分数|
+|result.createdate| Int64           | TimeStamp of data addition (MS)|
+|result.extension1| string          |代理 ID|
+
+
+##  成功的结果
+
+
+```json
+
+{
+    "status": 1,
+    "totalsize": 2,
+    "result": [
+        {
+            "user": "test1",
+            "extension1": "admin",
+            "sellbuy": "2",
+            "tradescore": "10.00",
+            "createdate": 1558980270793
+        },
+        {
+            "user": "test1",
+            "extension1": "admin",
+            "sellbuy": "1",
+            "tradescore": "10.00",
+            "createdate": 1558980270793
+        }
+    ]
+}
+
+```
+## 查无资料的结果
+```
+{"status":1, "totalsize": 0,"result":[]}
+```
+
+##  失败的结果
+
+```
+{
+"status": 0
+}
+```