QK Gaming

Appearance

注单接口文档 ​

💡 接口使用建议

  • 注单是以游戏派奖时间为准；拉取当前时间 10 分钟之前数据；建议拉取区间为 1-5 分钟，最大不能超过 90 分钟。我方注单每两分钟更新一次，建议每隔至少两分钟拉取一次，因为两分钟内多次拉取的注单也是重复注单。并强制限制至少每隔 10 秒才能拉取一次注单。
  • 响应中的资料时间均采用 UTC+8 时区。

🔐 认证与加密 ​

所有接口都需要进行认证与加密，详细的加密方式请参考：认证授权指南

📋 接口列表 ​

拉取注单 (s:16) ​

此功能用于拉取游戏注单记录，并提供两种响应格式因应不同开发需求。

1. 响应 d.list 为 栏位导向 (Column-oriented) 的物件 ​

  • 端点: {host}/getRecordHandle
  • HTTP 方法: GET
param 参数结构 ​
参数名类型必填描述
sInteger✅操作子类型 (固定为 16)
startTimeInteger✅查询起始时间戳 Unix timestamp in milliseconds
endTimeInteger✅查询结束时间戳 Unix timestamp in milliseconds
响应参数说明 ​
参数名类型描述
sInteger服务标识 (116=拉取注单接口)
mString接口路径
dObject数据对象
d.codeInteger响应码
d.startInteger查询起始时间
d.endInteger查询结束时间
d.countInteger回传资料笔数
d.listObject数据列表 (Column-oriented)
d.list.GameIDArray<String>游戏局号(小局号)
d.list.AccountsArray<String>玩家账号
d.list.ServerIDArray<String>游戏局号(大局号)
d.list.KindIDArray<Int>游戏代号(参考游戏列表)
d.list.TableIDArray<Int>桌号
d.list.ChairIDArray<Int>座位号
d.list.UserCountArray<Int>同房所在玩家数
d.list.CellScoreArray<String>有效投注额
d.list.AllBetArray<String>总成本 (总投注额 + 门票)
d.list.TicketFeeArray<String>门票
d.list.ProfitArray<String>总盈利 (输赢金额 - 门票)
d.list.RevenueArray<String>抽水金额
d.list.GameStartTimeArray<String>游戏开始时间
d.list.GameEndTimeArray<String>游戏结束时间
d.list.CardValueArray<String>牌局原始资料
d.list.ChannelIDArray<Int>代理商编号
d.list.CurrencyArray<String>币别
d.list.LanguageArray<String>游戏语系列表
d.list.RecordIdArray<Int>Record ID
d.list.CurScoreArray<String>初始分数
d.list.CreateTimeArray<String>注单创建时间
响应示例 ​
json
{
  "s": 116,
  "m": "/getRecordHandle",
  "d": {
    "code": 0,
    "start": 1760493600000,
    "end": 1760497200000,
    "count": 2,
    "list": {
      "GameID": [
        "50-1760495753-4400040-2916598-6-1",
        "50-1760495753-4400040-2916598-2-2"
      ],
      "ServerID": ["2916598", "2916598"],
      "KindID": [220, 220],
      "TableID": [4400040, 4400040],
      "ChairID": [6, 2],
      "UserCount": [2, 2],
      "CellScore": ["20", "10"],
      "TicketFee": ["0", "0"],
      "AllBet": ["20", "10"],
      "Profit": ["10", "-10"],
      "Revenue": ["0", "0"],
      "GameStartTime": ["2025-10-15 10:35:53", "2025-10-15 10:35:53"],
      "GameEndTime": ["2025-10-15 10:35:59", "2025-10-15 10:35:59"],
      "CardValue": [
        "0000001825240000000000000000002a16226",
        "0000001825240000000000000000002a16226"
      ],
      "ChannelID": [41, 41],
      "RecordId": [3053157, 3053156],
      "CurScore": ["1000000", "1000000"],
      "Currency": ["CNY", "CNY"],
      "CreateTime": ["2025-10-15 10:35:59", "2025-10-15 10:35:59"],
      "Accounts": ["sh1015P001", "sh1015P002"],
      "Language": ["zh_cn", "zh_cn"]
    }
  }
}

2. 响应 d.list 为 注单导向 (Row-oriented) 的物件阵列 (List 格式) ​

  • 端点: {host}/getRecordHandle/recordWithList
  • HTTP 方法: GET
param 参数结构 ​
参数名类型必填描述
sInteger✅操作子类型 (固定为 16)
startTimeInteger✅查询起始时间戳 Unix timestamp in milliseconds
endTimeInteger✅查询结束时间戳 Unix timestamp in milliseconds
响应参数说明 ​
参数名类型描述
sInteger服务标识 (116=拉取注单接口)
mString接口路径
dObject数据对象
d.codeInteger响应码
d.startInteger查询起始时间
d.endInteger查询结束时间
d.countInteger回传资料笔数
d.listArray<Object>数据列表 (Row-oriented)
d.list[].GameIDString游戏局号(小局号)
d.list[].AccountsString玩家账号
d.list[].ServerIDString游戏局号(大局号)
d.list[].KindIDInt游戏代号(参考游戏列表)
d.list[].TableIDInt桌号
d.list[].ChairIDInt座位号
d.list[].UserCountInt同房所在玩家数
d.list[].CellScoreString有效投注额
d.list[].AllBetString总成本 (总投注额 + 门票)
d.list[].TicketFeeString门票
d.list[].ProfitString总盈利 (输赢金额 - 门票)
d.list[].RevenueString抽水金额
d.list[].GameStartTimeString游戏开始时间
d.list[].GameEndTimeString游戏结束时间
d.list[].CardValueString牌局原始资料
d.list[].ChannelIDInt代理商编号
d.list[].CurrencyString币别
d.list[].LanguageString游戏语系列表
d.list[].RecordIdIntRecord ID
d.list[].CurScoreString初始分数
d.list[].CreateTimeString注单创建时间
响应示例 ​
json
{
  "s": 116,
  "m": "/getRecordHandle/recordWithList",
  "d": {
    "code": 0,
    "start": 1760493600000,
    "end": 1760497200000,
    "count": 2,
    "list": [
      {
        "GameID": "50-1760495753-4400040-2916598-6-1",
        "ServerID": "2916598",
        "KindID": 220,
        "TableID": 4400040,
        "ChairID": 6,
        "UserCount": 2,
        "CellScore": "20",
        "TicketFee": "0",
        "AllBet": "20",
        "Profit": "10",
        "Revenue": "0",
        "GameStartTime": "2025-10-15 10:35:53",
        "GameEndTime": "2025-10-15 10:35:59",
        "CardValue": "0000001825240000000000000000002a16226",
        "ChannelID": 41,
        "RecordId": 3053157,
        "CurScore": "1000000",
        "Currency": "CNY",
        "CreateTime": "2025-10-15 10:35:59",
        "Accounts": "sh1015P001",
        "Language": "zh_cn"
      },
      {
        "GameID": "50-1760495753-4400040-2916598-2-2",
        "ServerID": "2916598",
        "KindID": 220,
        "TableID": 4400040,
        "ChairID": 2,
        "UserCount": 2,
        "CellScore": "10",
        "TicketFee": "0",
        "AllBet": "10",
        "Profit": "-10",
        "Revenue": "0",
        "GameStartTime": "2025-10-15 10:35:53",
        "GameEndTime": "2025-10-15 10:35:59",
        "CardValue": "0000001825240000000000000000002a16226",
        "ChannelID": 41,
        "RecordId": 3053156,
        "CurScore": "1000000",
        "Currency": "CNY",
        "CreateTime": "2025-10-15 10:35:59",
        "Accounts": "sh1015P002",
        "Language": "zh_cn"
      }
    ]
  }
}

对局日志解析(URL)接口 (s:19) ​

此接口用于获取单个牌局的日志链接。

  • 端点: {host}/getRecordHandle
  • HTTP 方法: GET

NOTE

使用 getRecordHandle 端点，并指定 s=19。

param 参数结构 ​

参数名类型必填描述
sInteger✅操作子类型 (固定为 19)
idInteger✅原始记录 ID (同注单响应数据之 RecordId)
gameusernoString✅游戏小局号(同注单响应数据之 GameID)
LangString❌语系( 0 为中文(预设)，1 为英文)

响应参数说明 ​

参数名类型描述
sInteger服务标识 (119=对局日志解析(URL)接口)
mString接口路径
dObject数据对象
d.codeInteger响应码
d.gameLogURLString内嵌用链结

响应示例 ​

json
{
  "s": 119,
  "m": "/getRecordHandle",
  "d": {
    "code": 0,
    "gameLogURL": "{consoleHost}/#/gameLog?agent=41param=TP9WILUnSmzwKO0R5lhphO%2BnT54o1%2FEcAt3lOlkfKx2Ci7w0DFf0hluqtH2QJexCc17qAUmZb299IYx3m6swIA%3D%3D"
  }
}

📌 代码说明 ​

📘 响应码说明 ​

同游戏接口文档的响应码说明

Copyright © 2026 QK Gaming