QuickSDK
SDK聚合工具

更新日期：2025-12-04QuickSDK开放平台接入文档

一、 准备工作


使用 QuickSDK 开放接口获取 QuickSDK 相关游戏数据前，需要在QuickSDK后台-账号管理-数据接口api-开发者秘钥 里去获取使用接口的授权参数
QuickSDK 开放接口授权参数如下：
openId : 开发者身份
openKey : 开发者密钥，用于使用接口时加解密数据
同时，开发者应提供调用 API 的服务器白名单地址，使用白名单以外的服务器调用 API 会被拒绝
开放接口的 API 地址为 : https://www.quicksdk.com
完整的访问地址应为 API 地址 + 接口地址
所有接口均返回 json 格式字符串。
所有接口必须附带 sign 字段,具体算法参见第三章
Quick所有开放接口默认调用频率为 1000 次 / 分 , 每小时调用次数不超过 10000次



二、 接口列表


1. 获取游戏接入的所有渠道

1.1 接口地址

open/channelList


1.2 提交方式

HTTP POST


1.3 参数列表 

参数
 必要性
 说明
openId
 是
 开发者 ID
productCode
 是
 产品Code
time
 是
 接口请求时间戳
sign
 是
 签名

1.4 返回示例

{"status":true,"data":[{"channelName":"UCu4e5du6e38uff08u963fu91ccu6e38u620fuff09","channelCode":"9","marketOs":"1"}]}


2. 获取游戏配置的所有区服


2.1 接口地址

open/serverList


2.2 提交方式

HTTP POST


2.3 参数列表 

参数
 必要性
 说明
openId
 是
 开发者 ID
productCode
 是
 产品Code
time
 是
 接口请求时间戳
sign
 是
 签名

2.4 返回示例

{"status":true,"data":[{"serverName":"u516cu6d4b46-u5ba1u5224u8005u7684u7ec8u6781u56fdu5ea6"}]}


3. 获取游戏内角色信息


3.1 接口地址

open/roleInfo


3.2 提交方式

HTTP POST


3.3 参数列表 

参数
 必要性
 说明
openId
 是
 开发者 ID
productCode
 是
 产品 Code
serverName
 是
 游戏区服名称
time
 是
 接口请求时间戳
roleId
 否
 游戏内角色 ID (roleId,roleName,username 至少传 1 个)
roleName
 否
 游戏角色名
username
 否
 渠道用户名
sign
 是
 签名


3.4 返回示例
{"status":true,"data":{"total":1,"list":[{"uid":"114249300","username":"Doctorwalker","channelCode":"102","serverName":"u516cu6d4b28-u65e0u5c3du7684u96f7u9706u4e4bu6012","roleName":"DWalker","roleId":"11PI6I9","roleBalance":"0","roleLevel":"1","vipLevel":"0","guild":"0","lastLoginTime":"2016-02-24 01:57:34","createTime":"2016-02-24 01:58:01","loginTimes":"2","lastLoginDevice":"68CF043266647B034BDD7226ADD62B24","payTimes":"0","payAmount":"0","ip":"127.0.0.1"}]},"message":""}


3.5 字段说明

参数
 类型
 说明
uid
 string
 用户在渠道的UID
username
 string
 用户在渠道的 username
channelCode
 string
 QuickSDK 渠道号
serverName
 string
 游戏区服
roleName
 string
 角色名
roleId
 string
 角色 ID
roleBalance
 string
 角色游戏币余额
roleLevel
 string
 角色等级
vipLevel
 string
 角色VIP 等级
gulid
 string
 公会
lastLoginTime
 string
 最后登录 2015-01-01 23:32:00
createTime
 string
 创建时间 2015-01-01 23:32:00
loginTimes
 string
 登录次数
lastLoginDevice
 string
 最后登录设备
payTimes
 string
 支付次数
payAmount
 string
 累计支付总额
ip
 string
 最后登录 ip

3.6 其他说明

此接口最多返回符合条件的 10 条记录


4. 获取单日报表数据


4.1 接口地址

open/dayReport


4.2 提交方式

HTTP POST


4.3 参数列表

参数
 必要性
 说明
openId
 是
 开发者 ID
productCode
 是
 产品 Code
time
 是
 接口请求时间戳
channelCode
 否
 渠道 CODE(默认全部渠道)
bTime
 否
 查找条件开始日期(时间戳，默认从 7 天前开始)
eTime
 否
 查找条件结束日期(时间戳，默认到本日结束)起始时间，间隔不超过 30 天
usermb
 否
 1/0，是否以人民币币种返回数据
sign
 是
 签名

4.4 返回示例
{"status":true,"data":[{"date":"2015-09-03","channelName":"u6240u6709u6e20u9053","newUser":107439,"newDevice":177574,"userLogin":107531,"newPayUser":2441,"allPayUser":23145,"newUserPay":97015.4,"allPay":1935358.4,"firstPayUser":11477,"currency":null,"usermb":1},{"date":"2015-09-02","channelName":"u6240u6709u6e20u9053","newUser":100397,"newDevice":176052,"userLogin":99317,"newPayUser":2688,"allPayUser":18666,"newUserPay":103870.4,"allPay":1801172.2,"firstPayUser":8723,"currency":null,"usermb":1}],"message":""}


4.5 字段说明

参数
 类型
 说明
date
 string
 报表日期
channelName
 string
 渠道名称
newUser
 int
 新增用户
newDevice
 int
 新增设备
userLogin
 int
 活跃用户数
newPayUser
 int
 新用户付费数
allPayUser
 int
 总付费数
newUserPay
 string
 新用户充值额
allPa