Query Game Room List

1. Query Game Room List

Interface Path

• GET
• /api/game/list

Request Parameters

Parameter	Name	Type	Required	Description
agent_id	Merchant ID	string	Required	Merchant ID
game_id	Game ID	string	Optional	Filter by game ID. If not provided, returns all games. See Appendix
timestamp	Current Timestamp	int	Required	Timestamp when calling the interface (in milliseconds, valid for 10 minutes)
sign	Signature	string	Required	See interface description for signature algorithm

Response Parameters

Parameter	Name	Type	Description
code	Response Code	int	Error code
message	Response Message	string	Error message
data	Response Data	dict	Response data details
--list	Game Group List	Array	Room list grouped by game_id
----game_id	Game ID	string	Game ID, see Appendix
----game_name	Game Name	dict	Multilingual game name, key is language code
----rooms	Room List	Array	Rooms under this game
------game_id	Game ID	string	Game ID
------inst_id	Table ID	string	Table ID
------inst_name	Table Name	dict	Multilingual table name, key is language code
------status	Table Status	int	0 - Disabled, 1 - Enabled
------cover	Cover Image	string	Cover image URL
------cover_thumbnail	Cover Thumbnail	string	Cover thumbnail URL
------create_time	Create Time	int	Creation timestamp (milliseconds)
------update_time	Update Time	int	Last update timestamp (milliseconds)

Request Example

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

Response Example

{
    "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
                    }
                ]
            }
        ]
    }
}

Error Codes

200 Success
408000 Invalid request parameters
408003 IP whitelist restriction
408004 API rate limit exceeded
600100 Invalid signature
600101 Invalid parameters
700101 Merchant does not exist
700110 Merchant is disabled