一、 准备工作

使用 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	新用户充值额
allPay	string	总充值额
firstPayUser	int	新增付费用户数
currency	string	渠道币种符号（“¥”，“$”）
usermb	int	1/0，是否以人民币币种返回数据

4.6 其他说明

如游戏有使用 QuickSDK 接入海外渠道，QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示

如果需要获取固定汇率请联系 QuickSDK 工作人员

5. 获取每小时报表数据

5.1 接口地址

open/dayHourReport

5.2 提交方式

HTTP POST

5.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
time	是	接口请求时间戳
channelCode	否	渠道 CODE(默认全部渠道)
dateTime	否	查找条件日期(时间戳，默认当日时间)
usermb	否	1/0，是否以人民币币种返回数据
sign	是	签名

5.4 返回示例

{"status":true,"data":[{"date_hour":"2015-08-30 15:59:59","channelName":"u6240u6709u6e20u9053","newUser":32,"newDevice":0,"userLogin":202229,"newPayUser":0,"allPayUser":0,"newUserPay":3344,"allPay":13419.4,"firstPayUser":0,"currency":null,"usermb":1}],"message":""}

5.5 字段说明

参数	类型	说明
date_hour	string	报表时间
channelName	string	渠道名称
newUser	int	新增用户
newDevice	int	新增设备
userLogin	int	活跃用户数
newPayUser	int	新用户付费数
allPayUser	int	总付费数
newUserPay	string	新用户充值额
allPay	string	总充值额
firstPayUser	int	新增付费用户数
currency	string	渠道币种符号（“¥”，“$”）
usermb	int	1/0，是否以人民币币种返回数据

5.6 其他说明

如游戏有使用 QuickSDK 接入海外渠道，QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0，为 0 时 currency字段将返回使用的货币符号，同时直接以原始货币金额显示
如果需要获取固定汇率请联系 QuickSDK 工作人员

6. 获取玩家存留列表

6.1 接口地址

open/userLive

6.2 提交方式

HTTP POST

6.3 参数列表

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

6.4 返回示例

{"status":true,"data":[{"date":"2015-09-03","channelName":"u6240u6709u6e20u9053","newUser":107439,"live_2":59745,"live_3":33254,"live_7":0,"live_15":0},{"date":"2015-09-02","channelName":"u6240u6709u6e20u9053","newUser":100397,"live_2":51542,"live_3":35243,"live_7":0,"live_15":0}],"message":""}

6.5 字段说明

参数	类型	说明
date	string	报表日期
channelName	string	渠道名称
newUser	int	新增用户
live_2	int	次日存留
live_3	int	3 日存留
live_7	int	7 日存留
live_15	int	15 日存留

7. 获取渠道报表数据

7.1 接口地址

open/channelDaysReport

7.2 提交方式

HTTP POST

7.3 参数列表

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

7.4 返回示例
{"status":true,"data":[{"channelName":"u5929u8c61u4e92u52a8_Andorid","newUser":"16098","newDevice":"25871","allPayUser":"1016","allPay":98314,"currency":"$"},{"channelName":"u805au597du73a9","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"},{"channelName":"u866bu866b","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"},{"channelName":"u540cu6b65u63a8","newUser":0,"newDevice":0,"allPayUser":0,"allPay":0,"currency":"u00a5"}],"message":""}

7.5 字段说明

参数	类型	说明
channelName	string	渠道名称
newUser	int	新增用户
newDevice	int	新增设备
allPayUser	int	总付费数
allPay	string	总充值额
currency	string	渠道币种符号（“¥”，“$”）
usermb	int	是否以人民币计算

7.6 其他说明

如游戏有使用 QuickSDK 接入海外渠道,QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示
如果需要获取固定汇率请联系 QuickSDK 工作人员

8. 获取渠道日报表数据

8.1 接口地址

open/channelReport

8.2 提交方式

HTTP POST

8.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
time	是	接口请求时间戳
channelCode	否	渠道 CODE(默认全部渠道)
dateTime	否	查找条件开始日期(时间戳，默认从 7 天前开始)
usermb	否	1/0，是否以人民币币种计算(默认以人民币计算)
sign	是	签名

8.4 返回示例

{"status":true,"data":[{"channelName":"u7396u5ea6","newUser":"0","newDevice":"0","userLogin":"0","newPayUser":"0","allPayUser":"1","newUserPay":0,"allPay":6,"firstPayUser":"0","currency":"u00a5","usermb":"1"},{"channelName":"u540cu6b65u63a8","newUser":0,"newDevice":0,"userLogin":0,"newPayUser":0,"allPayUser":0,"newUserPay":0,"allPay":0,"firstPayUser":0,"currency":"u00a5","usermb":"1"}],"message":""}

8.5 字段说明

参数	类型	说明
channelName	string	渠道名称
newUser	int	新增用户
newDevice	int	新增设备
userLogin	int	活跃用户数
newPayUser	int	新用户付费数
allPayUser	int	总付费数
newUserPay	string	新用户充值额
allPay	string	总充值额
firstPayUser	int	新增付费用户数
currency	string	渠道币种符号（“¥”，“$”）
usermb	int	是否以人民币计算

8.6 其他说明

如游戏有使用 QuickSDK 接入海外渠道,QuickSDK 会默认按照固定汇率将海外货币转成人民币计算显示,如需显示原始货币及金额需指定 usermb 的值 0,为 0 时 currency字段将返回使用的货币符号,同时直接以原始货币金额显示
如果需要获取固定汇率请联系 QuickSDK 工作人员

9. 获取流失风险预警列表

9.1 接口地址

open/uwlLost

9.2 提交方式

HTTP POST

9.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
time	是	接口请求时间戳
channelCode	否	渠道 CODE(默认全部渠道)
dateTime	否	查找条件日期(时间戳，默认今日)
page	否	页码，默认第一页，每页返回 100 条数据
level	否	流失风险等级，取固定值，默认全部 0：全部等级 1：流失风险高 2：流失风险中 3：流失风险低
sign	是	签名

9.4 返回示例

{"status":true,"data":[{"channelName":"vivo","userId":"6b2a75296f112434","payAmount":0,"lastLoginTime":0,"loginWarn":"1","payWarn":"1","onlineWarn":"0","crashWarn":"0","askServiceWarn":"0","abuseWarn":"0","levelWarn":"0","warnLevel":"高"}],"message":""}

9.5 字段说明

参数	类型	说明
channelName	string	渠道名称
userId	string	用户 UID
payAmount	float	用户累计付费
lastLoginTime	int	用户最后登录时间戳
onlineWarn	int	是否近两日登录次数出现明显下滑（1 是，0 否）
crashWarn	int	玩家终端是否频繁崩溃
askServiceWarn	string	是否遇到问题较多 频繁联系客服
abuseWarn	string	是否辱骂客服 威胁退游
levelWarn	int	是否长时间等级停滞
payWarn	string	是否近期支付金额大幅下降
warnLevel	string	流失评估

10. 获取产品列表

10.1 接口地址

open/productList

10.2 提交方式

HTTP POST

10.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
sign	是	签名

10.4 返回示例

{"status":true,"data":[{"productName":"u6d4bu8bd5u6e38u620f","productCode":"11307116493328899400417645200944"}],"message":""}

10.5 字段说明

参数	类型	说明
productName	string	游戏名称
productCode	string	QuickSDK ProductCode
productKey	string	QuickSDK ProductKey
callbackKey	string	QuickSDK Callback_Key
md5Key	string	QuickSDK Md5_Key
gameType	int	游戏类型，取固定值： 1:角色扮演 2:卡牌对战 3:战略游戏 4:模拟游戏 5:休闲益智 6:竞技格斗 7:射击游戏 8:动作冒险 9:策略塔防 10:动作角色扮演 11:多人角色 12:竞技体育 13:音乐游戏
callbackUrl	string	游戏 Callback_Url

11. 获取广告计划效果报表

11.1 接口地址

open/adReport

11.2 提交方式

HTTP POST

11.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	QuickSDK 产品 CODE
sdate	必传	日志筛选时段开始日期，格式：YYYY-MM-DD
edate	必传	日志筛选时段结束日期，格式：YYYY-MM-DD
plans	选传	广告计划 CODE，可传多个计划 CODE,多个计划以“|”分隔
sign	是	签名

11.4 返回示例

{"status":true,"data":[],"message":""}

11.5 字段说明

参数	类型	说明
date	string	日期，格式为 YYYY-MM-DD
planCode	string	计划 Code
installNum	int	启动数
newUser	int	新增用户
dau	int	活跃用户
payNewUser	int	新用户付费数
payNewUserAmount	float	新用户付费额
pay_3	float	新增用户 3日 充值总额，计算LTV3为pay_3/newUser。以下 LTV 计算同理
pay_7	float	新增用户 7 日充值总额
pay_15	float	新增用户 15 日充值总额
pay_30	float	新增用户 30 日充值总额
pay_60	float	新增用户 60 日充值总额
payUser	int	总付费用户数
payAmount	float	总付费额
adChannel	string	计划推广渠道
adMedia_cost	float	媒体曝光环节中成本
live_N	int	N 日留存
ltvN	float	N 日 LTV

12. 获取订单列表

12.1 接口地址

open/orderList

12.2 提交方式

HTTP POST

12.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	QuickSDK 产品 CODE
btime	选传	日志筛选时段开始日期 ， 格式 ： YYYY-MM-DD HH:MM:SS，默认为当天 0 点
etime	选传	日志筛选时段结束日期 ， 格式 ： YYYY-MM-DD HH:MM:SS，默认为当前时间
channelList	选传	订单所在渠道 code，多个值以“,”分隔，不传则为全部渠道
page	选传	页码，默认为第一页。如果数据量多的情况下需要分页请求获取列表，每页数据 50 条
orderStatus	选传	订单状态,不传则查询全部订单，取固定值: 1 支付失败 2 尚未发货 3 发货失败 4 订单完成
sign	是	签名

12.4 返回示例

{"status":true,"data":[],"message":""}

12.5 字段说明

参数	类型	说明
marketOs	int	渠道类型，固定值 1 安卓 2 iOS 正版 3 iOS 越狱
channelName	string	渠道名称
server	string	区服
orderNo	string	订单号
userName	string	用户名
userId	string	用户 uid
roleName	string	角色名
amount	float	订单金额
currency	string	币种
createTime	int	订单创建时间，格式为 unix 时间戳
status	int	订单状态取固定值: 1 支付失败 2 尚未发货 3 发货失败 4 订单完成
channelOrderNo	string	渠道订单号
cpOrderNo	string	游戏订单号
extrasParams	string	订单扩展参数
payTime	int	订单支付成功时间，格式为 unix 时间戳
asyTime	int	订单同步游戏时间，格式为 unix 时间戳
goodsId	string	订单商品 ID
goodsName	string	商品名称
price	float	商品单价
channelCode	int	渠道号

13. 获取广告主列表

13.1 接口地址

open/getMediaApp

13.2 提交方式

HTTP POST

13.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
mediaType	是	广告媒体类型，固定值 Toutiao
sign	是	签名

13.4 返回示例

{"status":true,"data":[{"appId":"105","mediaId":"T1574740187","mediaName":"tt-test02"},{"appId":"89","mediaId":"T1592634692","mediaName":"tt-test01"}],"message":""}

13.5 字段说明

参数	类型	说明
appId	string	广告主 ID
mediaId	string	广告主媒体方 ID
mediaName	string	广告主名称

14. 获取广告计划分组列表

14.1 接口地址

open/getAdPlanGroup

14.2 提交方式

HTTP POST

14.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
sign	是	签名

14.4 返回示例

{"status":true,"data":[{"groupId":"817","groupName": "计划组 01" }],"message":""}

14.5 字段说明

参数	类型	说明
groupId	string	分组 ID
groupName	string	分组名称

15. 获取游戏分包列表

15.1 接口地址

open/getPackageVersion

15.2 提交方式

HTTP POST

15.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
sign	是	签名

15.4 返回示例

{"status":true,"data":[{"packId":"3","packName":"gg","versionNo":"121","versionName": "v1.21"}],"message":""}

15.5 字段说明

参数	类型	说明
packId	string	分包 ID
packName	string	分包名称
versionNo	string	分包版本号
versionName	string	分包版本名

16. 获取广告落地页列表

16.1 接口地址

open/getAdPages

16.2 提交方式

HTTP POST

16.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
sign	是	签名

16.4 返回示例

{"status":true,"data":[{ "pageId":"2","pageName":" 落地 页 多 图 0821","tempId":"5","tempName": "动态多图（配置可点图片）"}],"message":""}

16.5 字段说明

参数	类型	说明
pageId	string	落地页 ID
pageName	string	落地页名称
tempId	string	落地页模板 ID
tempName	string	落地页模板名

17. 创建广告计划

17.1 接口地址

open/createAdPlan

17.2 提交方式

HTTP POST

17.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
plans	是	计划名称，批量创建时以“,”分隔
platform	是	产品平台，可选值： APP：手机游戏 WEB：网页游戏
channelId	否	广告媒体ID（参考 广告 广告 open/getMediaChannel））
privateChannel	否	自定广告媒体名称，当传 channelId 时必填
mediaAppId	否	广告主 appId（参考广告主 open/getMediaApp）传 channelId 时可选填以创建广告媒体转化
convertSdkType	否	广告媒体转化方式，当传 mediaAppId 时必填，可选值： API：api 转化 SDK：sdk 转化
covertType	否	广告媒体转化类型，当传 mediaAppId 时必填，可选值： ACTIVITE：激活(无深度转化) ACTIVITE_REG：激活且注册 ACTIVITE_PAY：激活且付费 KEY_BEHAVIOR：关键行为(仅支持 SDK 转化) ACTIVITE_DEEP_PAY：激活(深度转化-激活&付费) ACTIVITE_DEEP_LIVE：激活(深度转化-激活&次留)
groupId	否	广告分组ID （参考 广告分组 open/getAdPlanGroup）
adPageId	否	落地页 ID（参考落地页列表 open/getAdPages）
note	否	备注
activeNode	是	转化节点，可选值： INSTALL：安装 REGISTER：注册 ROLE：创角 PAY：付费
urlType	是	下载链接方式，可选值： URL：手动填写 CLOUD：云端分包
gameUrl	否	下载链接，urlType 为手动填写时必填
package	否	包名，urlType 为手动填写时可用，当传 mediaAppId，并传包名时，广告计划将启动部署媒体转化；否则广告计划立即部署完成
gameVersionId	否	分包 ID （参 考 分 包 列 表 open/getPackageVersion），urlType 为云分包填写时必填
cpsList	否	云分包标识，urlType 为云分包填写时可用。当传分包标识时，多个标识以“,”分隔，且数量和顺序与计划名称一致；不传分包标识将使用计划 CODE作为标识
sign	是	签名 注意：如果 channelId 不为空，并且该广告媒体的 models 不为空（参考广告媒体列表接口 open/getMediaChannel），创建广告计划可附带媒体 models 附加参数 例如该媒体 models 返回["sign_key","encrypt_key"]，可附加参数为： sign_key string encrypt_key string models 参数也需要参与签名

17.4 返回示例

{"status":true,"data":{"success": 2,"total": 2,"list": [{"planName": "API_plan02","planCode": "K6wtm8"}] },"message":""}

17.5 字段说明

参数	类型	说明
success	Int	创建成功计划数量
total	Int	计划总数量
list	Object	计划列表
planName	string	计划名称
planCode	string	计划 CODE

18. 更新广告计划

18.1 接口地址

open/updateAdPlan

18.2 提交方式

HTTP POST

18.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 Code
action	是	更新方式，可选值： FROM_CODE：按计划更新 FROM_VERSION：按分包更新
plans	否	计划 CODE，多个计划以“,”分隔，当传 action 为计划更新时必填
urlType	是	下载链接方式，当传 action 为 FROM_CODE 时必填，可选值： URL：手动填写 CLOUD：云端分包
gameUrl	否	下载链接，urlType 为手动填写时必填
gameVersionId	否	分包 ID，urlType 为云分包填写时必填
oldVersionId	否	原分包 ID，当传 action 为 FROM_ VERSION 时必填，所有原分包 ID 的计划将更新为指定新分包 ID
newVersionId	否	新分包 ID，当传 action 为 FROM_ VERSION 时必填，所有指定分包 ID 的计划将更新为新分包 ID
sign	是	签名

18.4 返回示例

{"status":true,"data":[],"message":""}

18.5 字段说明

无

19. 获取广告计划列表

19.1 接口地址

open/getAdPlan

19.2 提交方式

HTTP POST

19.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 CODE
page	是	页码
pageRows	否	每页计划数量，默认 100
status	否	部署状态，默认 DEPLOY_COMPLETE，可选值： DEPLOY_WAITTING：等待部署 DEPLOY_PROCESS：正在部署 DEPLOY_COMPLETE：部署完成 DEPLOY_FAILD：部署失败
channelId	否	广告媒体 ID
adGroupId	否	广告分组 ID，不传为全部，传 0 为未分组
planCode	否	广告计划 CODE，可传此字段搜索计划
sign	是	签名

19.4 返回示例

{"status":true,"data": {"total": 7,"list": [{"planName": "测试计划组","planCode": "u7im9O","groupId": 817,"channelId": 4,"stat": "DEPLOY_COMPLETE","message": "部署完成
","createTime": 1598327640,"adPageUrl": "https://adtracking.quickjoy.com/s/u7im9O","downUrl": "https://adtracking.quickjoy.com/p/u7im9O"}]},"message":""}

19.5 字段说明

参数	类型	说明
total	Int	符合条件的广告计划数
list	Object	计划列表
planName	string	计划名称
planCode	string	计划 CODE
groupId	Int	广告分组 ID
channelId	Int	广告媒体 ID
stat	string	部署状态，参考请求参数
message	string	描述信息
createTime	Int	计划创建时间戳
adPageUrl	string	落地页链接
downUrl	string	下载短链

20. 消息推送(华为、OPPO、VIVO)

20.1 接口地址

open/pushMessage

20.2 提交方式

HTTP POST

20.3 参数列表

参数	必要性	说明
openId	是	开发者 ID
productCode	是	产品 CODE
channel_code	是	渠道 CODE，多个以“,”分隔
gateway	是	目标设备类型，取值： huawei 对应华为 vivo 对应 VIVO oppo 对应 OPPO
title	是	消息标题
body	是	消息内容
sign	是	签名

20.4 返回示例

{"status":true,"data":[],"message":""}

三、 签名规则

将去掉 sign 的所有参数按键名首字母自然排序排列
将所有参数按如下形式拼接 k1=v1&k2=v2&
在第二步的字符尾部拼接 openKey 的值
将前三步所得字符串 k1=v1&k2=v2&openKey 计算 MD5
所得 MD5 即为签名值