游戏列表与大厅 (Game List)

概述

• 接口说明：获取指定游戏厂商 (Provider) 或分类下的大厅游戏列表，并提供经过 WebP 压缩的游戏图标。

底层业务逻辑与说明 (Business Logic)

TIP

游戏列表在系统底层的处理非常注重安全防爬虫和渲染性能：

1. 参数加密防爬虫：请求参数中的 provider_code 或 game_comp 必须使用 Sha256 加密传输，后端解密后才会查库。如果抓包直接篡改明文 ID 将会被拦截。
2. 图片防盗链与本地化压缩：为了隐藏第三方真实的图片地址并提升加载速度，所有的游戏图标均通过独立图片网关 (/client/games/logo/...) 获取。网关会自动抓取原图，转换为体积更小的 .webp 或 .svg 格式，并缓存在服务器本地供前端读取。
3. 动态建表同步机制：针对集成平台上百款游戏的同步，后端在接收数据时会自动动态生成专用表（如 game_gsc_xxx），确保搜索和分类（Slot/Fish 等）响应极快。
4. 异常拦截：若玩家状态为“冻结 (user_status=2/3)”或正处于“强制修改密码 (setpassword=1)”状态，游戏大厅请求将直接阻断并抛出异常。

---

1. GET - 获取游戏大厅列表

• 路径: /client/games/list

请求 Header

参数名	类型	必填	说明
Authorization	String	是	Bearer Token

请求参数

参数名	类型	必填	说明
provider_code	String	是	游戏厂商代码，需经过 Sha256 加密
game_type	String	是	游戏分类，如 Slot, Live, Fish

响应示例

{
  "code": 0,
  "msg": "获取成功",
  "data": {
    "provider_name": "Pragmatic Play",
    "maintain_status": false,
    "list": [
      {
        "id": "vs20olympgate",
        "name": "Gates of Olympus",
        "icon": "https://api.domain.com/api/games/logo/pragmatic/vs20olympgate.webp",
        "type": "slot"
      }
    ]
  }
}