Skip to main content

Query Game Room List

1. Query Game Room List​

Interface Path​

  • GET
  • /api/game/list

Request Parameters​

ParameterNameTypeRequiredDescription
agent_idMerchant IDstringRequiredMerchant ID
game_idGame IDstringOptionalFilter by game ID. If not provided, returns all games. See Appendix
product_typeProduct TypestringOptionalFilter by product line: LIVE - live casino, AIGAME - AI games. No filtering if not provided; returns an empty list if it does not match game_id. Included in signature
timestampCurrent Timestampint64RequiredTimestamp when calling the interface (in milliseconds, valid for 10 minutes)
signSignaturestringRequiredSee interface description for signature algorithm

Response Parameters​

ParameterNameTypeDescription
codeResponse CodeintError code
messageResponse MessagestringError message
dataResponse DatadictResponse data details
--listGame Group ListArrayRoom list grouped by game_id
----game_idGame IDstringGame ID, see Appendix
----product_typeProduct TypestringLIVE - live casino, AIGAME - AI games
----game_nameGame NamedictMultilingual game name, key is language code
----roomsRoom ListArrayRooms under this game
------game_idGame IDstringGame ID
------inst_idTable IDstringTable ID
------inst_nameTable NamedictMultilingual table name, key is language code
------statusTable Statusint320 - Disabled, 1 - Enabled
------coverCover ImagestringCover image URL
------cover_thumbnailCover ThumbnailstringCover thumbnail URL
------create_timeCreate Timeint64Creation timestamp (milliseconds)
------update_timeUpdate Timeint64Last update timestamp (milliseconds)

Product Types​

product_typeGame IDs
LIVE101, 102, 103, 104, 105, 109, 113, 115, 301
AIGAME112, 114, 116, 117, 118, 20102, 20103, 202, 203, 204, 20401

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",
"product_type": "LIVE",
"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