多维度游戏列表过滤 (Advanced Game Filter)

概述

• 接口说明：通过高级查询条件（如分类、厂商、标签及关键字）筛选游戏列表。
• 鉴权说明：无需会员登录，但必须携带 Base Token 以识别 Agent。详情请参考基础认证。

1. GET - 游戏高级筛选

• 路径: /client/games/filter

请求 Header

参数名	类型	必填	说明
Authorization	String	是	Bearer BaseToken (用于识别 Agent)

请求参数

参数名	类型	必填	说明
currency	String	是	币种代码 (例如 CNY, USD)
category_code	String	否	游戏菜单/分类代码 (例如 Slot)
provider_code	String	否	厂商代码
tag_id	String	否	标签 ID (请传入 /client/games/tags 接口返回的 id，而非中文名)
name	String	否	游戏名称关键字模糊搜索
is_hot	Integer	否	筛选热门游戏 (传 1 表示只看热门)
is_recent	Integer	否	筛选最近常玩 (传 1 表示只看最近常玩)
page	Integer	否	页码，默认 1
pageSize	Integer	否	每页数量，默认 10

响应示例

{
  "code": 0,
  "msg": "获取成功",
  "data": {
    "total": 150,
    "page": 1,
    "pageSize": 10,
    "list": [
      {
        "id": "64f8a9b3e4b0c2a1",
        "name": "Sweet Bonanza",
        "icon": "https://cdn.domain.com/icons/sweetbonanza.webp",
        "type": "SLOT",
        "is_hot": true,
        "is_maintain": false
      }
    ]
  }
}

---

2. GET - 获取游戏标签列表

• 路径: /client/games/tags
• 说明: 玩家大厅专用接口，用于拉取后台配置的所有“游戏标签”（如“捕鱼达人”、“高爆率”等）。前端拿到这些标签后，可以将返回的 id 传入上面的高级筛选接口的 tag_id 参数中。

请求 Header

参数名	类型	必填	说明
Authorization	String	是	Bearer BaseToken (用于识别 Agent)

响应示例

{
  "code": 0,
  "msg": "获取成功",
  "data": [
    {
      "id": "64f8a9b3e4b0c2a123456789",
      "title": "捕鱼达人"
    },
    {
      "id": "64f8a9b3e4b0c2a987654321",
      "title": "asdfsdfdfdf"
    }
  ]
}