01JDB 接口是什么
JDB 在电子与街机品类的辨识度主要来自捕鱼类产品:多人同场、实时开火、按炮值结算。这决定了它的注单不是一局一条,而是按子弹或按结算周期汇总。
如果你的对账逻辑是照老虎机写的——一局一条记录、赢或输一个数——接捕鱼就会出错。要么按厂商给的汇总口径入库,要么自己按局号做聚合,两条路都要提前定。
02三种接入方式
电子游艺
常规老虎机类,注单结构简单,一局一条。
捕鱼类
多人同场,按炮值与命中结算,注单需要按局聚合。
街机类
节奏快、频次高,对钱包接口的响应时间更敏感。
03对接需要准备的字段
下面是最小字段集。字段命名各家不同,但语义基本固定——先把这张表填完,再去对厂商文档,能省掉一半来回。
| 字段 | 说明 |
|---|---|
user_id | 玩家标识 |
game_type | 游戏类型:电子 / 捕鱼 / 街机 |
room_id | 房间号,捕鱼类必填 |
bet_amount | 投注额,捕鱼类通常是炮值累计 |
payout | 派彩额 |
round_id | 局号,聚合对账的主键 |
对接流程
- 开户与权限:拿到商户号、密钥与测试环境,确认开放了哪些产品线。
- 钱包打通:先做单笔扣加,跑通幂等与超时补偿。
- 游戏入口:换取游戏地址或 token,验证前台跳转与返回。
- 注单回传:接回调,同时准备定时拉单做补偿。
- 对账与压测:按天比对全量注单,晚高峰压一轮钱包接口。
04这一类接口最常见的坑
- 用老虎机的口径接捕鱼:注单条数对不上,月底差一大截。
- 高频开火把钱包打挂:一秒多次扣款,接口没做批量或缓冲就等着报错。
- 房间配置写死:不同炮值对应不同房间,配置化才能按会员等级分配。
- 没做单局上限:捕鱼类容易出大额,风控阈值要单独设。
这些坑的共同点是:接口能通、数据不对。上线前用真实注单跑一遍全量对账,比在测试环境调通十个接口更有价值。
05常见问题
捕鱼类的注单为什么对不上?
因为它的结算粒度不是“一局一次输赢”,而是按开火与命中累计。要按厂商给的 round 维度聚合,否则条数和金额都会错。
高频扣款扛不住怎么办?
两种做法:一是钱包侧做合并扣款,二是接口做异步缓冲。前者口径清楚,后者实现快但对账要额外处理。
可以只接电子不接捕鱼吗?
一般可以按模块授权。如果你担心对账复杂,先接电子跑通,再单独排捕鱼的开发。
JDB 在手机上表现如何?
捕鱼类对触控和帧率敏感,建议在低端机上实测一遍,别只看旗舰机效果。
06其他厂商接口
JDB 接口可以单独接入,也可以与其他厂商一起走统一网关——字段、签名、回调全部封一层,前台只认一套协议。