使用流程及注意事项

呼叫方式

⚠️

Action 54 预计将 gType 移除，查询时请改用 mType

新增mType日期：

测试环境为 2025/05/26 10:00+8（一）
正式环境为 2025/06/02 10:00+8 (一）

移除gType日期：

测试环境为 2025/06/30 10:00+8（一）
正式环境为 2025/07/07 10:00+8 (一）

⚠️

预计调整报表的返回结果

棋牌下注记录
- roundSeqNo 格式改为字串型别
- playerIp、clientType 结果可能为空
老虎机下注记录
- playerIp、clientType 结果可能为空

生效日期

测试环境为 2025/06/05 17:00+8（四）
正式环境依序为
- 2025/06/24 07:00+8（二)
- 2025/06/25 13:00+8（三)
- 2025/06/26 07:00+8（四)

影响范围

Action 29、Action 44、Action 64

API 网址参考
- https://{API_Address}/apiRequest.do
JDB 将在「JDB API 正式环境设置资料.pdf」文件中提供 HTTP URI，以供 Operator 使用。
HTTP 调用示例

// POST /apiRequest.do HTTP/1.1
// Host: {API_Address}
// Content-Type: application/json
 
{
  "dc": "your domain",
  "x": "yWBxl0rtQ872ouQWz34cdNTX_QTW5Dm4_RmABEIkdJq_dljffhH0fMEoSNIRejPWBWkO09mq3FzdFmavh7E0kw",
  "parent": "if you have own iv, key different from your parent"
}

HTTP Body 参数说明

参数	说明
dc	客户域名
x	1. 参阅章节`功能项目`决定要呼叫的功能
	2. 依功能所需的参数转为 JSON String
	3. 将此 JSON String 先利用 AES-CBC-128 bit 进行加密，再用 Base64 URL 编码
	4. 加密步骤，可参考`范例程序`
parent	预设无此参数，仅适用独立设定使用，如需要请洽业务人员。
	使用方式为用独立的 `iv`、`key` 加密，并在呼叫我方时多带 `parent` 参数，内容为提供给我方设定 `iv`、`key` 的 parent 帐号

连线说明

API网址与加密金錀等信息，请参考「JDB API 正式环境设置资料.pdf」。
使用此系统时，客户须提供用联机的服务器 IP。

回传格式

仅提供JSON格式
HTTP压缩：用户可选择是否要压缩回传的讯息。如要压缩，需在 Http Request 的 header 中加入 "Accept-Encoding": gzip 设定

AES 加密注意事项

加密数据有效期为 30 秒，如果在 30 秒内未发送，则数据将会过期。 逾期时会收到 9005 的错误代码，请校正系统时间。
由于 AES 加密过程，是针对每个固定大小的区块进行转换，为了让加密能够顺利进行，必须将数据的 size 补齐到能够被 16 bytes 整除的大小，若不足时请使用空字符串向右补齐。

必要功能及说明

注册账号
- 请参考 Action 12：创建玩家
进行游戏
- 一般玩家
  - 利用段落 Action 11：取得游戏连结方式取得 path
  - 直接导向此path即可登入系统并进行游戏
- 试玩
  - 利用段落 Action 47：取得试玩游戏连结方式取得path
  - 直接导向此path即可登入系统并进行游戏
提款 / 存款
- 请参考 Action 19：提款/存款
- 可透过 Action 55：检查现金转账 (新版)
查询账号余额
- 请参考 Action 15：查询玩家数据
查询游戏记录
- 每日对帐报表：请参考 Action 42：每日对帐报表
- 明细记录：
  - 请参考 Action 29：查询游戏详细交易信息、 Action 64：查询历史游戏详细交易信息
单笔游戏结果：请参考 Action 54：查询游戏结果

Action 11：取得游戏连结