通知回调 API

🔔 核心功能

通知回调用于 QK 棋牌在特定事件发生时主动通知运营商。这些接口由运营商提供、QK 棋牌主动调用，与其他文档中「运营商呼叫 QK」的方向相反。

---

请求基本资讯

• 请求位置: 运营商在渠道设置中配置的地址（与单一钱包文档使用同一个渠道地址）
• HTTP 方法: GET

🔐 认证与加密

参数结构与转帐钱包文档一致（agent/timestamp/param/key，明文带 s={操作子类型}），加密方式请参考：认证授权指南

接口示例

{渠道地址}?agent={agent}&timestamp={timestamp}&param={param}&key={key}

📋 接口列表

玩家离线登出(s:11)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 11)
account	String	✅	玩家账号

玩家离开游戏时由 QK 棋牌发送。在「转帐钱包 + 离线回调」模式中，运营商可据此决定下分时机，搭配查询玩家总分(s:7)确认玩家当前余额。

param 加密前明文示例

s=11&account=10001_test01

运营商应回传

收到即可，建议回传：

{
  "d": {
    "code": 0
  }
}

⚠️ 最佳努力送达

通知回调为最佳努力送达（best-effort），QK 棋牌目前不会对失败的通知进行重试，运营商若需要更即时的余额同步，建议搭配查询玩家总分(s:7)主动轮询确认。