Action 11: 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	11
ts	Long	Y	Current system time
uid	String(50)	Y	PlayerID
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.`
remark	String(100)	N	Remark
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
cardGameGroup	String(5)	N	Card Game play group `Only a-z or A-Z or 0-9 allowed. (default:0)`
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": 11,
  "ts": 1447490495704,
  "uid": "testpl01",
  "lang": "cn",
  "gType": "0",
  "mType": "8001",
  "windowMode": "2",
  "lobbyURL": "https://xxx.xxx.xxx/lobby.html",
  "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)	Login URL

Operation Sample

// Http Request
  http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpo
hLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
  "status":"0000",
  "path":"https://xxx.xxx.xxx?x=Q0Y2NUZDNEFBODEzNUM5NURGRjc5QTUzRDk0RTlDRDUzNE
  Q0MjhEOEMzMSSSSSURDODBCNzdCMEE2OTE3MzczRkE5RDNGQ0QzQjdFNTlBMjE4Njg5ND
  M4RDREMEI1NkYzQjkxOEU5QTU0QTM5QTY1MEUyNjYzMDg1RkFBQTM1OUU3RTI2RTBGQU
  EzMUI0MkQ4NEFBRjVDNkJFRkQzMzU1NzA5OUNDMkYxMzMyOThBNjhBRURCNzExREMzRjh
  DNzA1N0VFNEIzMzhCNTFEQ0FDODVEODQ3NEFDNTE1MEE1NTMzODQ="
}
 
// 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"
}

Precautions and process description Action 47: Get Demo Game Launch URL