一、 准备工作

使用 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 接口地址