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 Type `If 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 URL `This 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 list `If 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"
}

User Manual & Precautions Action 47: Get Demo Game Launch URL