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 TypeIf 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 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 |
cardGameGroup | String(5) | N | Card Game play groupOnly 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 listIf 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"
}