自行开发接入
属于 API 自建方式,适合自行维护玩家账号、余额和游戏入口的团队。公开接口是你的服务端与游戏服务之间的协议,secret 和 token 不交给玩家浏览器。
1. 申请接入
按照应用与接入申请创建 API 自建应用,填写服务端出口 IP、完整回调地址并提交审核。通过后领取所选应用的接口地址、code 和 secret。
2. 实现服务端认证
按照签名认证生成签名,调用 create_token,核对认证结果并缓存 token。所有公开 API 请求均受服务器 IP 白名单限制。
3. 查询游戏并获取启动链接
按照游戏接口查询游戏目录,使用返回的 game_code 获取 launch_url。你的服务端保存需要的会话信息,只将完整启动链接交给浏览器,不自行拼接或修改链接。
4. 实现统一回调
提供一个完整 HTTP(S) 回调地址,按回调与结算验证签名,并按 event 处理事件及重复投递。先完成回调处理,再进行游戏结算联调。
若通过 iframe 打开游戏,可实现浏览器交互;窗口关闭与钱包结算完成是不同状态。
5. 联调与上线验证
使用专用测试玩家验证认证、目录、启动、回调、结算及退出,覆盖重复回调和失败重试。验证通过后再开放给玩家。