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
timestampCurrent TimestampintRequiredTimestamp 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
----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 Statusint0 - Disabled, 1 - Enabled
------coverCover ImagestringCover image URL
------cover_thumbnailCover ThumbnailstringCover thumbnail URL
------create_timeCreate TimeintCreation timestamp (milliseconds)
------update_timeUpdate TimeintLast 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