游戏及应用API接入文档

1. API地址

http://api.np.mobilem.360.cn

2. Sign算法

对于如下格式的URL:

/path/action?key1=value1&key3=value3&key2=value2&sign=xxxxxxxxxxxxxxxxx

签名串sign的计算方式如下:

  1. 去掉RequestString中的sign;

  2. 将剩下的Key-Value对按照Key的字符串升序排列后得到新串:

    key1=value1&key2=value2&key3=value3

  3. 在已排序RequestString后附加由360为渠道方分配的SecretKey:

    key1=value1&key2=value2&key3=value3key_assignd_by_360

  4. 计算该字符串的md5并转换为小写字符串作为请求中sign的值:

    sign = md5('key1=value1&key2=value2&key3=value3key_assignd_by_360')

  5. 计算签名字符串验证工具

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时间戳),单位为秒
  • Unix时间戳的生成,请参考:Unix时间戳
  • 该接口只提供给服务端获取数据使用,每日限制频次8000;请不要用于客户端;
  • 返回数据说明

    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时间戳),单位为秒
  • 该接口只提供给服务端获取数据使用,每日限制频次2000;请不要用于客户端;
  • 返回数据说明

    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分配)
  • 返回数据格式