游戏列表与大厅 (Game List)

概述

• 接口说明：这是获取大厅游戏列表的核心接口，专为常规大厅加载设计。它优先读取 Redis 缓存，响应极快，支持按厂商和分类进行查询。对于复杂的搜索和过滤，请使用多维度高级筛选。
• 鉴权说明：无需会员登录，但必须携带 Base Token 以识别 Agent。

---

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

• 路径: /client/games/list

请求 Header

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

请求参数

参数名	类型	必填	说明
currency	String	是	玩家对应的币种 (如 MYR, VND)
provider_code	String	否	游戏厂商代码，需经过 Sha256 加密传输
game_type	String	否	(统一参数) 游戏分类代码，如 SLOTS, LIVE
tag_id	String	否	标签 ID (例如 热门、推荐等自定义标签的真实底层 ID)

响应示例 (Standard Game Object)

{
  "code": 0,
  "msg": "获取成功",
  "data": {
    "total": 150,
    "page": 1,
    "pageSize": 20,
    "list": [
      {
        "id": "vs20olympgate",
        "name": "Gates of Olympus",
        "icon": "https://api.domain.com/api/games/logo/pragmatic/vs20olympgate.webp",
        "type": "SLOTS",
        "is_hot": true,
        "is_maintain": false
      },
      {
        "id": "sweetbonanza",
        "name": "Sweet Bonanza",
        "icon": "https://api.domain.com/api/games/logo/pragmatic/sweetbonanza.webp",
        "type": "SLOTS",
        "is_hot": false,
        "is_maintain": true
      }
    ]
  }
}

💡 业务逻辑建议

• 前端渲染：前端实现一个通用的 GameCard 组件，接收上述数组中的单个对象。依靠 is_hot 控制角标展示，依靠 is_maintain 控制灰色遮罩和拦截进入动作，彻底抛弃多套 UI。
• 后端缓存与分流：
  • 此接口 (/client/games/list) 会直接读取高性能 Redis 缓存。
  • 带有模糊搜索和复杂分页的请求应跳过此接口，调用 /client/games/filter。