交易日志增加traceid的返回、请求

transfer/en/API_release_version.md

@@ -10,4 +10,5 @@
   |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.8| ADD:  [Get User Balance Transaction Records] /api/game/usertradeinfo  | 2025.2.6 |
+  |1.1.8| ADD:  [Get User Balance Transaction Records] /api/game/usertradeinfo  | 2025.2.6 |
+  |1.2.13| (1) [获得交易记录] "/api/game/usertradeinfo"   Added returns and requests for unique "traceid"  | 2025.2.6 |

transfer/en/usertradeinfo.md

@@ -17,14 +17,15 @@
 |--------|-----|--------|--------|
 |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|
+| traceid     | string | N    | Unique id query (If the traceid is not empty, you do not need to enter the following parameters)              |
+| user       | String | N    | player account queried                                                         |
+|startdate|     String     |N|	        Need to convert datetime to long  format. 1517265756000 : 2018/01/30 06:42:36(GMT+8)Start date and time|
+|enddate|       String     |N|	        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
+## Example1
 - URL:
     - http://127.0.0.1:8000/api/game/usertradeinfo
 - HTTP Method
@@ -40,6 +41,19 @@
     page:0
     pagesize:20
     ```
+
+## Example2
+- URL:
+    - http://127.0.0.1:8000/api/game/usertradeinfo
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    cert:v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    extension1:adminweb
+    traceid:fasdferq2432
+    ```
 	
 	
 ##  Return Result
@@ -53,7 +67,7 @@
 |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|
-
+|result.traceid     | string          | Unique id |
 
 ## Successful  Result
 
@@ -69,14 +83,16 @@
             "extension1": "admin",
             "sellbuy": "2",
             "tradescore": "10.00",
-            "createdate": 1732500566495
+            "createdate": 1558980270793,
+            "traceid": "fasdferq2432"
         },
         {
             "user": "test1",
             "extension1": "admin",
             "sellbuy": "1",
             "tradescore": "10.00",
-            "createdate": 1732500566495
+            "createdate": 1558980270793,
+            "traceid": "fasgfd345fs"
         }
     ]
 }

transfer/zh/API_release_version.md

@@ -11,3 +11,4 @@
 | 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.2.13| (1) [获得交易记录] "/api/game/usertradeinfo"   增加唯一"traceid"的返回、请求  | 2025.2.6 |

transfer/zh/usertradeinfo.md

@@ -17,14 +17,15 @@
 | ---------- | ------ | ---- | ------------------------------------------------------------------------ |
 | 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)结束时间日期 |
+| traceid     | string | N    | 唯一id查询(traceid 不为空时,后面的参数无需填写)                  |
+| user       | String | N    | 所查询的玩家账号   |
+| startdate  | String | N    | 开始时间戳(毫秒); 1517265756000 : 2018/01/30 06:42:36(GMT+8)起始时间日期 |
+| enddate    | String | N    | 结束时间戳(毫秒); 1517265756000 : 2018/01/30 06:42:36(GMT+8)结束时间日期 |
 | page       | Int32  | N    | 资料页码, 从 0 开始                                                      |
 | pagesize   | Int32  | N    | 最大值 1000                                                              |
 
 
-## 示例
+## 示例1
 - URL:
     - http://127.0.0.1:8000/api/game/usertradeinfo
 - HTTP Method
@@ -40,6 +41,19 @@
     page:0
     pagesize:20
     ```
+
+## 示例2
+- URL:
+    - http://127.0.0.1:8000/api/game/usertradeinfo
+- HTTP Method
+    -   POST
+- 表单数据
+    > Content-Type: application/x-www-form-urlencoded
+    ``` 
+    cert:v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y
+    extension1:adminweb
+    traceid:fasdferq2432
+    ```
 	
 	
 ##  返回结果
@@ -53,6 +67,7 @@
 |result.sellbuy|    double          |1-是向玩家转入分数  ，  2-是玩家转出分数|
 |result.createdate| Int64           | TimeStamp of data addition (MS)|
 |result.extension1| string          |代理 ID|
+|result.traceid     | string          |唯一ID|
 
 
 ##  成功的结果
@@ -69,14 +84,16 @@
             "extension1": "admin",
             "sellbuy": "2",
             "tradescore": "10.00",
-            "createdate": 1558980270793
+            "createdate": 1558980270793,
+            "traceid": "fasdferq2432"
         },
         {
             "user": "test1",
             "extension1": "admin",
             "sellbuy": "1",
             "tradescore": "10.00",
-            "createdate": 1558980270793
+            "createdate": 1558980270793,
+            "traceid": "fasgfd345fs"
         }
     ]
 }