Action 21: Get Game Launch URL
Function Description
- This function provides users a game launch URL to login the system.
- Game launch URL valid for 1 minute.
- There is an additional
postMessage
notification while redirecting player to the designated lobby url. Please check appendix for more details.
Parameter
Parameter | Format | Mandatory | Description |
---|---|---|---|
action | Integer | Y | 21 |
ts | Long | Y | Current system time |
parent | String(50) | Y | Agent ID |
uid | String(50) | Y | PlayerID Only a - z and 0 - 9 and underscores (_) and hyphens (-) allowed. If the UID is in Uppercase, the system will automatically convert it to lowercase |
lang | String | N | Language See Language Code Given any language that is not in the list above will be treated as English by default. |
gType | String(3) | N | Game types See Game Provider |
mType | String(6) | N | Machine TypeIf you need to enter the game directly, you need to bring in mType and gType at the same time. |
windowMode | String(1) | N | 1: With using the JDB game lobby. (Default)If gType and mType are not specified, users will directly enter the game lobby. If gType and mType are specified, users will directly enter the game. 2: Without using the JDB game lobby. gType and mType fields are required |
isAPP | Boolean | N | Whether to enter the game for the mobile app. true: mobile app false: mobile webpage, desktop webpage (Default) |
lobbyURL | String(100) | N | Game lobby URLThis parameter will only work when windowMode is 2. Lobby button will be hidden, when lobbyURL is empty. The url must use https in game provider HRG. Game provider CreedRoomz, ZestPlay does not support this feature. |
mute | Integer | N | Sound Setting: 0: Open (Default) 1: Mute |
jackpotFlag | Integer | N | Jackpot On-Off Flag Setting: 0: ON (Default) 1: OFF |
isShowDollarSign | Boolean | N | Whether to show dollar sign true: show dollar sign (Default) false: don’t show dollar sign |
activityIds | String Array | N | Activity ID listIf you have any needs, contact JDB service. |
Example
{
"action": 21,
"ts": 1447490495704,
"parent": "testag",
"uid": "testpl01",
"gType": "0",
"mType": "8001",
"activityIds": ["1234", "5678"]
}
Return Results
Parameter | Format | Description |
---|---|---|
status | String(4) | Success: 0000 Error: See Error Codes in Appendix |
err_text | String(255) | Error message |
path | String(255) | Launch Game URL |
systemSessionId | String(150) | System Session ID, will be different in each login when using action 21 get game launch url.Game Type supports range: SLOT(0), FISH(7), ARCADE(9), LOTTERY(12), CARD(18) This is not included by default, contact JDB service if needed. |
Operation Sample
// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
// Http Response (success)
{
"status": "0000",
"path": "http://xxx.xxx.xxx?x=Q0Y2NUZDNEFBODEzNUM5NURGRjc5QTUzRDk0RTlDRDUzNEQ0MjhEOEMzMURDODBCNzdCMEE2OTE3MzczRkE5RDNGQ0QzQjdFNTlBMjE4Njg5NDM4RDREMEI1NkYzQjkxOEU5QTU0QTM5QTY1MEUyNjYzMDg1RkFBQTM1OUU3RTI2RTBGQUEzMUI0MkQ4NEFBRjVDNkJFRkQzMzU1NzA5OUNDMkYxMzMyOThBNjhBRURCNzExREMzRjhDNzA1N0VFNEIzMzhCNTFEQ0FDODVEODQ3NEFDNTE1MEE1NTMzODQ="
}
// Http Response (error)
{
"status": "9005",
"err_text": "Assertion(SAML) didn't pass the timestamp validation."
}
// If the game is under maintenance, we will return:
{
"status": "9022",
"err_text": "Game is maintained. mType: 8001"
}