Transfer
JDB 平台 API
玩家登入
Action 11:取得游戏连结

Action 11:取得游戏连结

功能说明

  • 此功能提供用户在登入系统时须使用的游戏连结。
  • 游戏连结有效时间为 1 分钟。
  • 游戏中「返回大厅」时另有 postMessage 通知,请参阅 附录 说明。

参数

参数格式强制说明
actionIntegerY11
tsLongY当前系统时间
uidString(50)Y玩家账号
langStringN语系
参照附录 语系代码
尚未支援该语系的游戏预设将以英文开启
gTypeString(3)N游戏类型
参照附录 游戏提供商
mTypeString(5)N机台类型
若需直接进入游戏,需同时带入 mType 及 gType
remarkString(100)N备注
windowModeString(1)N1:使用 JDB 游戏大厅(默认值)
若未带入 gType 及 mType,则直接到游戏大厅
若带入 gType 及 mType 时,直接进入游戏。
2:不使用 JDB 游戏大厅
gType 及 mType 为必填字段。
isAPPBooleanN是否为手机 APP 进入游戏
true:手机APP
false:手机网页、计算机网页(默认值)
lobbyURLString(100)N游戏大厅网址
当 windowMode 为 2 时,此参数才会有作用。
当 lobbyURL 为空时,不显示大厅按钮。
在游戏商 HRG 中 url 必须使用 https。
游戏商 CreedRoomz、ZestPlay 不支援此功能。
muteIntegerN默认音效开关
0:开启音效(默认值)
1:静音
cardGameGroupString(5)N棋牌游戏群组
只限 a-z、A-Z、0-9 英文与数值组合(默认值 0)
isShowDollarSignBooleanN是否显示币别符号
true:显示币别符号(默认值)
false:不显示币别符号
activityIdsString ArrayN活动识别代号列表
如有需要请洽业务人员。
eventIdLongN免费场次识别代号
如果填入该字段,启动游戏时将直接跳转至免费场次模式。
请先创建免费场次 Action 72:创建免费场次

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"],
  "eventId": 12345
}

返回结果

参数格式说明
statusString(4)成功:0000

错误:参照附录 错误代码
err_textString(255)错误讯息
pathString(255)登入URL

操作范例

// 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."
}
 
// 若游戏正在维护中,我方会回传:
{
    "status": "9022",
    "err_text": "Game is maintained. mType: 8001"
}