Seamless
JDB Platform API
Functions
Get Game URL
Action 21: Get Game Launch URL

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

ParameterFormatMandatoryDescription
actionIntegerY21
tsLongYCurrent system time
parentString(50)YAgent ID
uidString(50)YPlayerID
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
langStringNLanguage
See Language Code
Given any language that is not in the list above will be treated as English by default.
gTypeString(3)NGame types
See Game Provider
mTypeString(6)NMachine Type

If you need to enter the game directly, you need to bring in mType and gType at the same time.
windowModeString(1)N1: 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
isAPPBooleanNWhether to enter the game for the mobile app.
true: mobile app
false: mobile webpage, desktop webpage (Default)
lobbyURLString(100)NGame 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.
muteIntegerNSound Setting:
0: Open (Default)
1: Mute
jackpotFlagIntegerNJackpot On-Off Flag Setting:
0: ON (Default)
1: OFF
isShowDollarSignBooleanNWhether to show dollar sign
true: show dollar sign (Default)
false: don’t show dollar sign
activityIdsString ArrayNActivity 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

ParameterFormatDescription
statusString(4)Success: 0000
Error: See Error Codes in Appendix
err_textString(255)Error message
pathString(255)Launch Game URL
systemSessionIdString(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"
}