GameList
- Amy Guo (Unlicensed)
- John Chen
URl: https://{{gmag_game_data_url}}/game/list?hash={{xxx}}
Method: POST.
Purpose: This method returns the list of games provided by Gmag, which includes the game’s detailed information.
The brand should call the gameList method to search game information with different restrictions including providerCode, gameType, gameCode and etc.
GameSearch must use a specific API domain gmag_game_data_url. For the real domain, please check the brand account information from GM-Ag.
Request
Name | Type | Required | Description |
|---|---|---|---|
providerCode | String(32) | No | The code of a Game Provider. |
gameType | String(32) | No | The game type to get game list for a specific game type. |
gameCode | String(32) | No | The game code value to to retrieve the specific game. |
page | Int | No | The page number to retrieve, default value = 1. |
size | Int | No | The number of records per page, default value = 100. |
Response
Name | Type | Required | Description |
|---|---|---|---|
total | Int | Yes | The total number of games. |
pages | Int | Yes | The total pages of games. |
sizes | Int | Yes | The number of games per page. |
records | Array | Yes | Array of games, it could be empty. |
current | Int | Yes | Current Page number. |
GameList
Name | Type | Required | Description |
|---|---|---|---|
gameCode | String(32) | Yes | The unique identifier of the game. |
gameType | String(32) | Yes | The type pf the game. (Please refer to GameType table below for more information) |
cnName | String(255) | Yes | The Chinese name of a game. |
enName | String(8) | Yes | The English name of a game. |
providerCode | String(32) | Yes | The code of a Game Provider. |
mobile | int(2) | Yes | Will be 1 if the game supports mobile, otherwise 0. |
desktop | int(2) | Yes | Will be 1 if the game supports desktop, otherwise 0. |
freeGame | int(2) | Yes | Will be 1 if the game supports free game, otherwise 0. |
freeSpin | int(2) | Yes | Will be 1 if the game supports free spin, otherwise 0. |
goldenChip | int(2) | Yes | Will be 1 if the game supports golden chip, otherwise 0. |
progressive | int(2) | Yes | Will be 1 if the game supports progressive, otherwise. |
released | int(2) | Yes | Will be 1 if the game is released, otherwise 0. |
jackpotName | String(255) | No | The name of the game, occurs when progressive is 1. |
jackpotTicker | String(255) | No | The ticker of the jackpot, occurs when progressive is 1. |
description | String(2048) | No | The description of the game. |
rtp | String(255) | No | The rtp of the game. |
reels | String(255) | No | The reels of the game. |
lines | String(255) | No | The lines of the game. |
releaseDate | DateTime | No | The released date of the game. |
resourceLink | String(1023) | No | The resource link of the game |
imgDefault | String(1023) | No | The default image of the game. |
imgCn | String(1023) | No | The Chinese image of the game. |
tableAlias | String(1023) | No | The table_alias of the game, only occurs when gameType is live. |
status | int(2) | Yes | The status of a game. (active, end, under maintaining) |
GameType
Name | Description |
|---|---|
slots | Game type of slot. A slot machine is a game with spinning reels. Those reels have symbols on them, which land randomly after you place a bet and spin the reels. |
table | Game type of table, games played at tables. |
live | Game type of live, which is shown via a live streaming video link, in real time from a casino table. |
arcade | Games type of arcade, such as fishing. |
sport | Game type of sport, games through sports competition. |
esport | Game type of esport, games through e-sports competition. |
lotto | Game type of lotto, select number and win prize. |
poker | Game type of poker. |
other | Other type of games. |
Request example
{
"requestId": "requestId1234",
"brandId": "1",
"gameType":"slot",
"size": 2,
"page": 1
}Response example
//success
{
"requestId": "requestId1234",
"error": "0",
"message": "SUCCESS",
"total": 1783,
"current": 1,
"size": 2,
"pages": 892,
"records": [
{
"gameCode": "gf_2226",
"gameType": "slot",
"cnName": "HotSpin",
"enName": "HotSpin",
"providerCode": "gf",
"mobile": 1,
"desktop": 1,
"freeGame": 0,
"freespin": 0,
"goldenChip": 0,
"progressive": 0,
"released": 1,
"status": 1
},
{
"gameCode": "gf_2202",
"gameType": "slot",
"cnName": "Wolf Disco",
"enName": "Wolf Disco",
"providerCode": "gf",
"mobile": 1,
"desktop": 1,
"freeGame": 0,
"freespin": 0,
"goldenChip": 0,
"progressive": 0,
"released": 1,
"status": 1
}
]
}
//error
{
"requestId": "requestId1234",
"error": "P_02",
"message": "Invalid hash",
}