游戏列表查询

获取当前 Agent 已授权激活的可用游戏列表。

接口信息

属性	值
路径	POST /papi/v1/game/list
认证	Agent Token（Bearer）
Content-Type	application/x-www-form-urlencoded

请求头

Header	值	必填
Authorization	Bearer {agent_token}	✅ 必填

请求参数

参数名	类型	必填	说明
provider	string	否	游戏商编码（例如 GSC / SA / WM）
operator_code	string	否	运营商编码（会与 Token 绑定的 Agent Code 进行一致性校验）
game_type	string	否	游戏分类（如 SLOT / LIVE / LOTTERY / POKER 等），与 category 等价
category	string	否	游戏分类，优先度高于 game_type
currency	string	否	结算货币代码，只返回支持该币种的游戏（传 all 则不过滤）
page	int	否	当前页码，默认 1
pageSize	int	否	每页数据量，默认 10，最大限制 100

请求示例

curl -X POST https://api.example.com/papi/v1/game/list \
  -H "Authorization: Bearer {agent_token}" \
  -d "provider=GSC&operator_code=OP001&game_type=SLOT&page=1&pageSize=20"

响应字段

Data 字段结构

字段	类型	说明
list	array	游戏对象列表
total	int	总条数
page	int	当前页码
pageSize	int	每页条数

list[Item] 结构

字段	类型	说明
id	string	游戏 GUID
name	string	游戏名称
code	string	游戏代码
category_code	string	游戏分类代码（对应数据库中的 game_type）

成功响应

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": "0ea6ad82fb0e4b898da5af7e274cb742",
        "name": "鱼虾蟹黄金轮",
        "code": "5031",
        "category_code": "SLOT"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "msg": "获取成功"
}

失败响应

{
  "code": 7,
  "data": {},
  "msg": "operator_code mismatch"
}