跳到主要内容

查询游戏房间列表

1、查询游戏房间列表​

接口路径​

  • Get
  • /api/game/list

请求参数​

参数名称类型必填说明
agent_id商户 IDstring必填商户 ID
game_id游戏 IDstring选填按游戏 ID 过滤，不传则返回全部游戏，详见 附录
timestamp当前时间戳int64必填传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign签名string必填签名算法详见接口说明

响应参数​

参数名称类型说明
code响应码int错误码
message响应信息string错误信息
data响应数据dict响应数据详情
--list游戏分组列表Array按 game_id 分组的房间列表
----game_id游戏 IDstring游戏 ID，详见 附录
----game_name游戏名称dict多语言游戏名称，key 为语言代码
----rooms房间列表Array该游戏下的房间
------game_id游戏 IDstring游戏 ID
------inst_id台桌 IDstring台桌 ID
------inst_name台桌名称dict多语言台桌名称，key 为语言代码
------status台桌状态int320-停用，1-启用
------cover封面图片string封面图片 URL
------cover_thumbnail封面缩略图string封面缩略图 URL
------create_time创建时间int64创建时间戳（毫秒）
------update_time更新时间int64更新时间戳（毫秒）

请求范例​

curl --location 'https://staging.aig1234.com/api/game/list?agent_id=agent001&timestamp=1734417873301&sign=7776e923ffee88bbd5293fa8ad4a9919' \
--header 'Content-Type: application/json'

响应范例​

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "game_id": "101",
                "game_name": {
                    "en-US": "Baccarat",
                    "zh-CN": "百家乐"
                },
                "rooms": [
                    {
                        "game_id": "101",
                        "inst_id": "DYfsRc",
                        "inst_name": {
                            "en-US": "Table 1",
                            "zh-CN": "台桌1"
                        },
                        "status": 1,
                        "cover": "https://cdn.aig1234.com/cover/bac_01.jpg",
                        "cover_thumbnail": "https://cdn.aig1234.com/cover/bac_01_thumb.jpg",
                        "create_time": 1700000000000,
                        "update_time": 1734417873000
                    }
                ]
            }
        ]
    }
}

错误码​

200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
600101 参数不合法
700101 商户不存在
700110 商户已禁用