Action 21：取得游戏连结
功能说明
- 此功能提供用户在登入系统时须使用的游戏连结。
- 游戏连结有效时间为 1 分钟。
- 游戏中「返回大厅」时另有 postMessage 通知，请参阅 附录 说明。
参数
| 参数 | 格式 | 强制 | 说明 |
|---|---|---|---|
| action | Integer | Y | 21 |
| ts | Long | Y | 当前系统时间 |
| parent | String(50) | Y | 代理账号 |
| uid | String(50) | Y | 玩家账号，只限 a-z、0-9、底线（_）、连字符（-）。只限小写的英文与数值组合，若输入大写的英文，系统会自动转为小写存入同一个 DC 底下的账号不可以重复。 |
| lang | String | N | 语系 参照附录 语系代码 尚未支援该语系的游戏预设将以英文开启 |
| gType | String(3) | N | 游戏类型 参照附录 游戏提供商 |
| mType | String(6) | N | 机台类型若需直接进入游戏，需同时带入 mType 及 gType |
| windowMode | String(1) | N | 1：使用 JDB 游戏大厅（默认值）若未带入 gType 及 mType，则直接到游戏大厅若带入 gType 及 mType 时，直接进入游戏。2：不使用 JDB 游戏大厅 gType 及 mType 为必填字段。 |
| isAPP | Boolean | N | 是否为手机 APP 进入游戏 true：手机 APP false：手机网页、计算机网页（默认值） |
| lobbyURL | String(100) | N | 游戏大厅网址当 windowMode 为 2 时，此参数才会有作用。 当 lobbyURL 为空时，不显示大厅按钮。 在游戏商 HRG 中 url 必须使用 https。 游戏商 CreedRoomz、ZestPlay 不支援此功能。 |
| mute | Integer | N | 默认音效开关 0：开启音效（默认值） 1：静音 |
| jackpotFlag | Integer | N | 设定彩金开关 0：打开 1：关闭 |
| isShowDollarSign | Boolean | N | 是否显示币别符号 true：显示币别符号（默认值） false：不显示币别符号 |
| activityIds | String Array | N | 活动识别代号列表如有需要请洽业务人员。 |
| eventId | Long | N | 免费场次识别代号如果填入该字段，启动游戏时将直接跳转至免费场次模式。请先创建免费场次 Action 72：创建免费场次 |
Example
{
"action": 21,
"ts": 1447490495704,
"parent": "testag",
"uid": "testpl01",
"gType": "0",
"mType": "8001",
"activityIds": ["1234", "5678"],
"eventId": 12345
}返回结果
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功：0000 错误：参照附录 错误代码 |
| err_text | String(255) | 错误讯息 |
| path | String(255) | 开启游戏连结 |
| systemSessionId | String(150) | 系统阶段唯一码，每次 action 21 取得游戏连结会获得不同值。游戏类型支援范围：老虎机(0)、捕鱼机(7)、街机(9)、电子彩票(12)、棋牌(18)预设无此参数，如需要请洽业务人员 |
操作范例
// 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."
}
// 若游戏正在维护中，我方会回传：
{
"status": "9022",
"err_text": "Game is maintained. mType: 8001"
}