DOC《如何接入应用宝》

如何接入应用宝 提供内容步骤 建立HTTP站点并符合应用宝的json文件规范.

在openqq.com填写对应的网址. 通过刷新网址调测. 提供数据方式 目前应用宝支持从HTTP站点抓取内容,HTTP内容以json文件方式提供,应用宝会主动到HTTP站点抓取数据并.以下是json文件标准. 【注意点】 填写字符串类型时,不要使用特殊字符,如 音频字段说明 图片类型 属性 描述 必填 是否有多个 类型 备注 url 图片url Y 字符串 长度不超过200 height 图片高度 正整数 width 图片宽度 正整数 地域类型 属性 描述 必填 是否有多个 类型 备注 country_name 国家名 字符串 长度不超过50 province_name 省份 字符串 长度不超过50 city_name 城市名 字符串 长度不超过50 code_name 区域编码或者县区 字符串 长度不超过50 town_name 乡镇名称 字符串 长度不超过50 village_name 村名称 字符串 长度不超过50 street_name 街道名称 字符串 长度不超过50 street_no_name 街道号 字符串 长度不超过50 detail_name 详细地址 字符串 长度不超过200 铃声类型 属性 描述 必填 是否有多个 类型 备注 duration 时长 Y 正整数型 单位是秒 content_size 铃声大小 浮点型 单位是MB encoding_format 铃声格式 字符串型 download 下载URL 字符串型 长度限制为200 free_type 免费 Y 正整数型 0代表免费 1代表收费 2代表会员免费 基础字段 属性 描述 必填 是否有多个 类型 备注 email 邮件 字符串 长度不超过20 developer 开发者 字符串 长度不超过50 company 公司名 字符串 长度不超过50 homepage 主页 字符串 长度不超过200 update_time 更新时间 字符串 文件数据被修改的时间 格式为: yyyy-MM-dd hh:mm:ss 音频数据属性说明表 对应json的rings 属性 描述 必填 是否有多个 类型 备注 id 唯一id值Y字符串 长度不超过20 name 音频名称 Y 字符串 长度不超过100 alternative_headline 音频别名 Y 字符串 长度不超过200 多个别名以,号做为分隔符 cover 封面图片 图片类型 thumbnail 封面图片缩略图 图片类型 description 描述(摘要) Y 字符串 长度不超过500 tag 关键词 Y Y 字符串 长度不超过200 以,号做为分隔符,搜索关键字 publisher 歌手 Y 字符串 长度不超过100 create_time 创建时间 字符串 数据创建的时间 格式为: yyyy-MM-dd hh:mm:ss modify_time 修改时间 Y 字符串 数据被修改的时间 格式为: yyyy-MM-dd hh:mm:ss price 价格 价格 单位为元,最小价格是0.01元location 地域/国家 地域类型 如果为空,默认为中国 text 文字内容 字符串 在详情页的文字信息 image 图片内容 Y 图片类型 在详情页的图片内容 ring 铃声内容 Y 铃声类型 在详情页的视频内容 weburl web页面URL 字符串 长度限制为200 appurl app页面URL Y 字符串 长度限制为200 h5url H5页面URL 字符串 长度限制为200 json文件格式说明 { "android"安卓包,必填 { "app_name": "myapp", "package_name": "com.myapp" } ], "ios"ios包,选填 { "app_name": "myapp", "app_store_id": "123456" } ], "email": "[email protected]"email地址,选填 "developer": "jingdong"开发者,选填 "company": "jingdong"公司名称,选填 "homepage": "http://www.jd.com"公司主页,选填 "webPrefix": "example.com", "nativePrefix": "example://", "update_time": "2015-04-01 13:12:10"文件更新时间 "rings": [ { "weburl": "http://example.com/ctivity?id=123"web地址 ,选填 "appurl": "example://activity&id=123"app页面跳转地址,必填 "h5url": "http://www.m.jd.com/fashion.html", //h5地址,选填 "id": "1"唯一ID,必填 "name": "优惠活动"内容名称,必填 "alternative_headline": "test1"内容别名,多个别名之间以,做为分割符 "cover"封面图片,选填 url:图片地址 height:图片高度 width:图片宽度 "thumbnail"封面图片缩略图,选填 url:图片地址 height:图片高度 width:图片宽度 "description": "买一送一"描述(摘要),必填 "tag": "服装,优惠"关键词,关键词之间以,做为分割符,必填 "author": "杨过"作者,选填 "create_time": "2015-04-17 13:25:30", //创建时间,选填 "modify_time": "2015-04-17 13:25:30", //修改时间,必填 "price": "0.01"价格,选填 "location"地理,选填 "country_name":"中国"国家名 "province_name": "广东"省份 "city_name":"深圳"城市名 "code_name":"南山区"区域编码或者县区 "town_name"乡名称 "village_name"村名称 "street_name ":"深南大道"街道名称 "street_no_name":"10000号", //街道号 "detail_name":"腾讯大厦13楼" //详细地址 "text": "文本内容"文字内容,选填 "image" url: "http://123.com/123.jsp"图片地址 height: "670"图片高度 width: "670"图片宽度 ], "ring": [ { "duration":"138"时长 "content_size":"2.5"视频大小 "encoding_format":"flv", //视频格式 "download":"test"下载URL "free":"test"是否免费 } ], "min_version": "123456"支持该页面跳转的最低版本号,选填 } ] } 交互方式说明 【应用宝请求时HTTP协议】 缓存类型为no-cache 头部的Accept为text/json,Accept-Charset为utf-8 【返回数据时HTTP协议要求】 内容类型:application/json;

charset=utf-8 头部:Access-Control-Allow-Origin为* 注意点 必填代表内容必填,如果为空,则该内容应用宝会忽略这段内容 选填代表内容可不填 APP支持跳转 为了使用户能够从应用宝的结果中直接跳到指定页面,开发者需要使 App 支持外部调用.应用宝使用 AppURL 来指向一个可以在 App 中展现的资源,AppURL 的格式: {scheme}://{host_path} 制定统一的 URI 指向 App 的内容 我们推荐开发者将 scheme 设为 app_name,将host_path 设为 page/type/id,也就是使用 app_name://page/type/id 的方式来指向 App 的内容.例如,一个优酷的视频播放页可以被描述为:youku://play/video/12321;

一个多看的电子书详情页可以被描述 为:duokan://detail/ebook/21312. 在Android Manifest 文件中注册 intent-filter 对于一个可以展示 {app_name}://{page}/{type}/{id} 所指向资源的 activity 添加如下 intent-filter: 使用 am 指令进行测试 通过如下指令测试调起,如果能够正确地调起页面展示数据则说明 intent-filter 设置成功. adb shell am start -W -a "android.intent.action.VIEW" -d "yourUri" yourPackageName 刷新应用宝 安全策略 对于内容开放有安全要求的开发者,应用宝提供安全认证的方式,防止其他厂商获取内容. 在开发者首次提交验证申请时,应用宝服务器将发送GET请求到填写的URL上,并且带上三个参数(signature、timestamp、randstr),开发者通过对时间(timestamp)和签名(signature)的效验,来判断此条消息的真实性. 此后,每次开发者接收应用宝请求消息的时候,应用宝也都会带上前面三个参数(signature、timestamp、randstr)访问开发者设置的URL,开发者依然通过对签名的效验判断此条消息的真实性. 参数 描述 signature 应用宝加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、randstr参数. timestamp 时间戳 randstr 随机字符串 加密/校验流程如下: 1. 将token、timestamp、randstr三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行sha1加密 3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于应用宝