1. API地址
http://api.np.mobilem.360.cn
2. Sign算法
对于如下格式的URL:
/path/action?key1=value1&key3=value3&key2=value2&sign=xxxxxxxxxxxxxxxxx
签名串sign的计算方式如下:
去掉RequestString中的sign;
将剩下的Key-Value对按照Key的字符串升序排列后得到新串:
key1=value1&key2=value2&key3=value3
在已排序RequestString后附加由360为渠道方分配的SecretKey:
key1=value1&key2=value2&key3=value3key_assignd_by_360
计算该字符串的md5并转换为小写字符串作为请求中sign的值:
sign = md5('key1=value1&key2=value2&key3=value3key_assignd_by_360')
3. 数据返回格式
3.1 默认格式 JSON
3.2 可选格式 JSONP
如果在请求串中包含 callback=xxxxxxxx
部分,返回数据将自动使用JSONP格式
3.3 错误返回
如果请求出错,会返回如下格式的数据,其中errno为内部错误号,errMsg为错误信息: {"errno":xxxxxx,"errMsg":"XXXXXX"}
4. 应用接口
4.1 获取应用列表
请求URL
/app/list
是否需要签名
是
调用频次限制
有,相邻两次请求间隔不得小于5秒
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
type | 应用类型(1-软件,2-游戏),默认不区分应用类型 | 否 |
page | 分页号,默认值1 | 否 |
pagesize | 每次请求返回的记录最大数量,默认20,最大值300 | 否 |
starttime | 按时间返回获取应用的起始时间(Unix时间戳),单位为秒 | 否 |
endtime | 按时间返回获取应用的结束时间(Unix时间戳),单位为秒 | 否 |
返回数据说明
Key | 内容 |
---|---|
total | 满足条件的总数据数量 |
start | 分页使用的起始偏移量 |
num | 本次请求返回的数据数量 |
items | 具体的应用信息(数组) |
items详细数据说明
key | 说明 |
---|---|
id | 应用编号,该应用在360市场的唯一标识 |
packageName | 应用包名 |
minVersion | 最低系统版本要求 |
minVersionCode | 最低系统版本编码 |
name | 应用名称 |
categoryName | 分类信息,[父分类:子分类](多个,空格分隔) |
description | 应用描述信息 |
developer | 作者/公司 |
iconUrl | icon下载地址 |
screenshotsUrl | 截图地址,逗号分隔 |
incomeShare | 是否支持分成 |
rating | 应用评分(十分制) |
versionName | 版本名称 |
versionCode | 版本编号 |
boxLabel | 应用角标(0:无,1:首发,2:最新,3:热门,4:独家,5:推广,6:活动,7:特权) |
priceInfo | 付费信息 |
tag | 标签(多个,空格分隔) |
downloadTimes | 下载次数 |
downloadUrl | 最新版下载地址(市场类产品请不要使用该属性,由于同步时差,下载到的apk版本号可能与您保存的版本号不一致。) |
rDownloadUrl | 当前版本下载地址(市场类产品请使用这个属性) |
apkMd5 | apk包的md5值 |
apkSize | 应用大小,单位byte |
createTime | 应用入库时间 |
updateTime | 最近更新时间 |
updateInfo | 最近更新信息 |
appPermission | 应用权限配置 |
brief | 一句话简介 |
language | 应用语言 |
signatureMd5 | 包内MD5签名 |
isAd | 是否含广告标识 |
isOnline | 是否处于上线状态(1:上线,0:已下线) |
4.2 获取指定编号的应用信息
请求URL
/app/get
是否需要签名
是
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
appid | 应用编号,多个编号请使用半角逗号 , 分隔 |
是 |
返回数据说明
Key | 内容 |
---|---|
total | 满足条件的总数据数量 |
start | 分页使用的起始偏移量 |
num | 本次请求返回的数据数量 |
items | 具体的应用信息(数组) |
items详细数据说明
参考 4.1
4.3 获取下线应用列表
请求URL
/app/offline
是否需要签名
是
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
starttime | 按时间返回获取应用的起始时间(Unix时间戳,默认值为当前时间的前一天),单位为秒 | 否 |
page | 分页号,默认值1 | 否 |
pagesize | 每次请求返回的记录最大数量,默认20,最大值300 | 否 |
返回数据说明
Key | 内容 |
---|---|
total | 满足条件的总数据数量 |
start | 分页使用的起始偏移量 |
num | 本次请求返回的数据数量 |
items | 具体的应用信息(数组) |
items详细数据说明
key | 说明 |
---|---|
id | 应用编号,该应用在360市场的唯一标识 |
packageName | 应用包名 |
name | 应用名称 |
4.4 获取CPS游戏列表
请求URL
/app/cpsgames
是否需要签名
是
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
start | 分页使用的起始偏移量,默认0 | 否 |
num | 每次请求返回的记录最大数量,默认20,最大300 | 否 |
starttime | 按时间返回获取应用的起始时间(Unix时间戳),单位为秒 | 否 |
endtime | 按时间返回获取应用的结束时间(Unix时间戳),单位为秒 | 否 |
返回数据说明
Key | 内容 |
---|---|
total | 满足条件的总数据数量 |
start | 分页使用的起始偏移量 |
num | 本次请求返回的数据数量 |
items | 具体的应用信息(数组) |
items详细数据说明
key | 说明 |
---|---|
id | 应用编号,该应用在360市场的唯一标识 |
name | 应用名称 |
packageName | 应用包名 |
description | 应用描述信息 |
developer | 作者/公司 |
iconUrl | icon下载地址 |
incomeShare | 是否支持分成 |
rating | 应用评分 |
tag | 标签(多个,空格分隔) |
downloadUrl | 应用下载地址(数组)元素格式为:{应用编号: 下载地址} |
5. 跳转接口
5.1 应用下载跳转接口
请求URL
/redirect/down
是否需要签名
否
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
appid | 应用编号 | 是 |
返回数据格式 无
5.2 网页跳转接口
请求URL
/redirect/
是否需要签名
否
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
返回数据格式 无
6. 分类接口
6.1 分类接口
请求URL
/cat/list
是否需要签名
是
参数列表
参数名 | 参数说明 | 是否为必选参数 |
---|---|---|
from | 渠道号(由360分配) | 是 |
返回数据格式 无