API-优化每日推送接口

docs/PlayX-接口文档.md

@@ -38,6 +38,36 @@
 | `lifetime_total_deposit` | number | 否 | 历史总充值 |
 | `lifetime_total_withdraw` | number | 否 | 历史总提现 |
 
+##### 格式 B：新版批量上报（兼容你截图）
+新版 body 形如：
+```json
+{
+  "report_date": "1700000000",
+  "member": [
+    {
+      "member_id": "123456",
+      "login": "john",
+      "lty_deposit": 15230.75,
+      "lty_withdrawal": 12400.50,
+      "yesterday_total_w": -320.25,
+      "yesterday_total_deposit": 500.00
+    }
+  ]
+}
+```
+
+字段映射（服务端内部会转换成旧字段再计算）：
+- `report_date` -> `date`（若为 Unix 秒则转为 `YYYY-MM-DD`）
+- `member[].member_id` -> `user_id`
+- `member[].login` -> `username`
+- `member[].yesterday_total_w` -> `yesterday_win_loss_net`
+- `member[].yesterday_total_deposit` -> `yesterday_total_deposit`
+- `member[].lty_deposit` -> `lifetime_total_deposit`
+- `member[].lty_withdrawal` -> `lifetime_total_withdraw`
+
+返回补充：
+- 批量模式会在 `data` 里增加 `results[]`，每个成员一条结果（是否 `deduped`）。
+
 #### 幂等规则
 * 幂等键：`user_id + date`
 * 重复推送：不会重复入账，返回 `data.deduped=true`
@@ -97,6 +127,49 @@ curl -X POST 'http://localhost:1818/api/v1/playx/daily-push' \
 }
 ```
 
+#### 示例（新版批量上报）
+请求：
+```bash
+curl -X POST 'http://localhost:1818/api/v1/playx/daily-push' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "report_date": "1700000000",
+    "member": [
+      {
+        "member_id": "123456",
+        "login": "john",
+        "lty_deposit": 15230.75,
+        "lty_withdrawal": 12400.50,
+        "yesterday_total_w": -320.25,
+        "yesterday_total_deposit": 500.00
+      }
+    ]
+  }'
+```
+
+返回（首次写入至少一个成员时的示例）：
+```json
+{
+  "code": 1,
+  "msg": "",
+  "time": 0,
+  "data": {
+    "request_id": "report_2023-11-14",
+    "accepted": true,
+    "deduped": false,
+    "message": "Ok",
+    "results": [
+      {
+        "user_id": "123456",
+        "accepted": true,
+        "deduped": false,
+        "message": "Ok"
+      }
+    ]
+  }
+}
+```
+
 ---
 
 ## 2. PlayX -> 积分商城（商城调用 PlayX）