360手机助手移动开放平台接入规范v0.3.doc

文文 档档 编编 号号版本号版本号密级密级 mp 3mp 3rd rd spec01 spec010 30 3 高高 移动开放平台规范移动开放平台规范 360360 移动开放平台接口规范移动开放平台接口规范共共 1010 页页 360360 移动开放平台接口规范移动开放平台接口规范 奇虎科技奇虎科技 目录目录 1 重要约定重要约定 3 2 第三方应用商店第三方应用商店 4 2 1 接口方式接口方式 4 2 2 接口标准接口标准 4 2 3 嵌入嵌入 JS 接口说明接口说明 6 3 第三方音乐 电子书 视频第三方音乐 电子书 视频 8 3 1 接口方式接口方式 8 3 2 接口标准接口标准 8 1 重要约定重要约定 在内容审查方面 360 的直接竞争对手产品如 QQ 手机管家 瑞星手机 安全 金山手机卫士等等不可出现在首页推荐或排行榜上 但可以收 录 360 公司的产品位置可由 360 公司要求进行摆放 当第三方内容有服务升级 内容调整 服务器升级或服务变更时 务 必提前通知 360 360 联系方式 李俊 lijun2 第三方应用商店第三方应用商店 2 1 接口方式接口方式 第三方应用商店提供页面 内嵌在 360 手机助手中 如下图所示 图表图表 1 第三方应用商店集成样图第三方应用商店集成样图 2 2 接口标准接口标准 由第三方提供页面 页面分为两部分 分别是软件页面和游戏页面 用 于 360 手机助手的装软件和玩游戏入口 左侧是第三方应用商店的导航 只支持一级 如果第三方有分类内容 可在页面中自行灵活调整 如应用汇 右侧页面宽度为 842 高度不限 用滚动条控制 默认高度是 596 左侧导航的图标是第三方 logo 大小为 34 34 并提供一个静态 url 用 于链接此 logo 例如 cdn 加速 提供搜索接口 为保持搜索位置的统一性 搜索 UI 入口由 360 手机助 手提供 第三方提供一个搜索的 url 如 只需提供到 xxx 之前的 url 即可 即 utf8 方式拼接到 url 中传给第 三方 由第三方进行搜索并返回相关页面 效果如下图所示 图表图表 2 第三方应用商店搜索示意图第三方应用商店搜索示意图 页面中需要嵌入一段 js 脚本用于和客户端的交互 样例请参考 soft test html 和 softmgr new source js 详细说明请参考 1 3JS 参数说明 2 3 嵌入嵌入 JS 接口说明接口说明 组织组织 Json 对象对象 需要将页面中的所有 apk 下载资源组成一个 Json 对象 如 soft test html 中的 g soft info 变量 需要 10 个属性 分别是 id 第一个数字 url version channelName iconUrl packageName size apkMd5 a pkCate softname Json 对象对象样式如下 var g soft info 7 url version 2 channelName 安卓市场 iconUrl com otheri mop size 387737 apkMd5 A590fa5a4d282c9edc820b665c 04022f8 apkCate 聊天交友 softname 猫扑社区 103348 url version 9 channelName 103349 渠道名称 iconUrl packageName com eg android AlipayGphone size 1990448 apkMd5 c89 a128b3b8594fbf63e9f9d4f5b89f0 apkCate 掌上购物 softname 支付宝 参数说明如下 url apk 包下载地址 version apk 版本号 对应 versionCode 字段 channelName 渠道名称 iconUrl apk 的 icon 图标的链接地址 packageName 包名 size 软件大小 用字节数来表示 apkMd5 apk 包的 md5 apkCate 软件分类 softname 软件名 下载按钮事件下载按钮事件 代码在 softmgr new source js 文件中 downloadSoft function params 下载软件 var soft id params id 该 ID 是页面点击下载按钮那里 传进 来一个软件 ID 说明是要下载哪个 var type params type params type download var soft name 每个软件下载按钮点击后 传一个 ID 的参数 用这个 ID 去软 件数据的对象列表里查询复合的软件 var cur status obj g soft info soft id var cur status cur status soft id for var key in cur status obj cur status key cur status obj key cur status cur status var client p type cur status soft name alert 传递的参数 client p try window external SoftMgr Notify 2 client p catch e 3 第三方音乐 电子书 视频第三方音乐 电子书 视频 3 1 接口方式接口方式 第三方音乐 电子书 视频方提供页面 内嵌在 360 手机助手中 页面如 下图所示 图表图表 3 第三方音乐合作示意图第三方音乐合作示意图 3 2 接口标准接口标准 左侧是第三方应用商店的导航 只支持一级 如果第三方有分类内容 如多米音乐 可在页面中自行灵活调整 右侧页面宽度为 842 如果有滚动条 则实际宽度为 825 像素 高度不 限 用滚动条控制 默认高度是 596 左侧导航的图标是第三方 logo 大小为 34 34 并提供一个静态 url 用 于链接此 logo 例如 cdn 加速 开放平台资源页下载链接规范 1 资源的下载 url 需可以直接下载 即无重定向 在下载 url 中需包含文 件名称 name s 用以通知 360 手机助手客户端在下载列表里显示的名称 具体编码格式见后面说明 2 在下载 url 中包含文件后缀名称 360ext s 客户端根据此结合名称 生成完整文件名 3 如果 name 字段在 url 中间 要确保文件名之后有 示例 原始 URL 接入助手后 ental 29 360ext mp3 必要参数 name显示的资源名字 客户端下载队列中显示 360ext 小写文件扩展名 name 360ext 下载后的本地文件名 提供搜索接口 为保持搜索