bot-28/docs/admin-third-game-order-api.md

后台三方游戏订单

请求头统一使用：

Authorization: Bearer <token>

1. 订单列表

GET /admin/thirdGame/orders

列表读取系统数据库，不会直接请求三方。

参数	必填	说明
page / limit	否	默认 1/20，limit 最大 200
user_id	否	系统数据库用户主键，精确匹配
member_id	否	系统会员 ID，精确匹配
username	否	系统用户名，模糊匹配
first_name	否	系统昵称，模糊匹配
player_id	否	三方玩家 ID，精确匹配
platform	否	三方游戏平台，如 ag、pg
game_order_id	否	三方订单号，精确匹配
game_type	否	1视讯、2老虎机、3彩票、4体育、5电竞、6捕猎、7棋牌
status	否	0未完成、1已完成、2已取消、3已撤单
start_time / end_time	否	订单更新时间范围，必须同时传，格式 Y-m-d H:i:s

返回：

{
  "code": 0,
  "data": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "list": [
      {
        "id": 1,
        "user_id": 123,
        "member_id": "10001",
        "username": "test01",
        "first_name": "测试用户",
        "player_id": "p1234567890",
        "platform": "ag",
        "currency": "CNY",
        "game_type": 1,
        "game_type_text": "视讯",
        "game_name": "Baccarat",
        "round": "88888888",
        "table": "88888888",
        "seat": "88888888",
        "bet_amount": 100,
        "valid_amount": 95,
        "settled_amount": -100,
        "bet_content": "Banker",
        "status": 1,
        "status_text": "已完成",
        "game_order_id": "000001",
        "bet_time": "2026-08-21 01:00:00",
        "last_update_time": "2026-08-21 01:05:00"
      }
    ],
    "options": {
      "game_types": [],
      "statuses": []
    }
  }
}

2. 同步三方订单

POST /admin/thirdGame/orders/sync

{
  "start_time": "2026-08-21 00:00:00",
  "end_time": "2026-08-21 06:00:00",
  "page": 1,
  "limit": 2000
}

单次时间范围最多 6 小时，只能同步最近 15 天。返回：

{
  "code": 0,
  "data": {
    "received": 100,
    "synced": 100,
    "matched_users": 20,
    "unmatched_orders": 0,
    "total": 100,
    "page_no": 1,
    "page_size": 2000,
    "has_more": false
  }
}

同步成功后重新请求订单列表。has_more = true 时等待至少 10 秒，再使用相同时间范围请求下一页。

普通同步至少间隔 1 分钟且每小时最多 5 次；翻页同步至少间隔 10 秒。失败时 code != 0，原因读取 msg。