应用宝有什么用

一、如何接入应用宝

1.建立HTTP站点并符合应用宝的json文件规范。

2.在填写对应的网址。

3.通过刷新网址调测。

二、提供数据方式

目前应用宝支持从HTTP站点抓取内容，HTTP内容以json文件方式提供，应用宝会主动到

HTTP站点抓取数据并。以下是json文件标准。

【注意点】

填写字符串类型时，不要使用特殊字符，如

[%--`~!@#$^&*()=|{}':;',[].<>/?~！@#￥……&*（）——|{}【】。

三、团购字段说明

图片类型

属性描述必填是否有多个类型备注

url图片urlY字符串长度不超过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

基础字段

属性描述必填是否有多个类型备注

email邮件字符串长度不超过20

developer开发者字符串长度不超过50

company公司名字符串长度不超过50

homepage主页字符串长度不超过200

web_prefix网页域名字符串长度不超过50

native_prefix跳转域名字符串长度不超过50

update_time更新时间字符串



文件数据被修改的

时间



格式为：

yyyy-MM-ddhh:mm:ss

评论类型

属性描述是否必填是否有多个类型备注

comment_te

xt评论Y字符串长度不超过100

comment_ti

me评论时间Y字符串



有效期开始的时

间



格式为：

yyyy-MM-dd

hh:mm:ss

creator评论者Y字符串长度不超过50

团购数据属性说明表

对应json的groupbuy

属性描述必填是否有多个类型备注

id唯一id值Y字符串长度不超过20

name名称Y字符串长度不超过100

alternative

_headline别名Y字符串



长度不超过200



多个别名以,号

做为分隔符

cover封面图片Y图片类型

thumbnail

封面图片

缩略图图片类型

description

描述(摘

要)Y字符串

提示，限制条件等，

长度不超过500

tag关键词YY字符串



长度不超过200



以,号做为分隔

符，搜索关键字

shop_name商家信息Y字符串长度不超过100

shop_desc商家简介字符串长度不超过200

hot_level级别正整数

location区域Y地域类型

如果为空，默认为中

国

create_time创建时间字符串



数据创建的时间



格式为：

yyyy-MM-dd

hh:mm:ss

modify_time修改时间Y字符串



数据被修改的时

间



格式为：

yyyy-MM-dd

hh:mm:ss

start_time开始时间Y字符串



有效期的开始时

间



格式为：

yyyy-MM-dd

hh:mm:ss

end_time结束时间Y字符串



有效期的结束时

间



格式为：

yyyy-MM-dd

hh:mm:ss

genre类型YY字符串

最大长度为50，类型

（美食、旅游等），

多个类型以,号作为

分隔符

image图片内容Y图片类型

在详情页的图片内

容

value原价Y浮点型

单位为元，最小价格

是0.01元

price现在价格Y浮点型

单位为元，最小价格

是0.01元

offer优惠信息字符串长度限制为100

bought_coun

t

已经购买

人数Y正整数

comment用户评论Y评论类型

comment_web

_url

评论页

weburl字符串长度限制为100

comment_app

_url

评论页

appurl字符串长度限制为100

status状态Y正整数

1为上架，0为下架，

默认为1

weburl

web页面

URL字符串长度限制为200

appurl

app页面

URLY字符串长度限制为200

h5url

H5页面

URL字符串长度限制为200

min_version

支持APP

跳转的最

低版本号正整数

例如

:

11

json文件格式说明

{

"android":{//安卓包，必填

"app_name":"myapp",

"package_name":""

},

"ios":{//ios包，选填

"app_name":"myapp",

"app_store_id":"123456"

},

"email":"",//email地址，选填

"developer":"jingdong",//开发者，选填

"company":"jingdong",//公司名称，选填

"homepage":"",//公司主页，选填

"web_prefix":"",

"native_prefix":"example://",

"update_time":"2015-04-0113:12:10",//文件更新时间

"groupbuy":[

{

"weburl":"",//web地址，选填

"appurl":"example://activity&id=123",//app页面跳转地址，必填

"h5url":"",//h5地址，选填

"id":"1",//唯一ID，必填

"name":"速度与激情8",//内容名称，必填

"alternative_headline":"Fast&Furious",//内容别名，多个别名之间以,做

为分割符

"shop_name":"四海一家",//店铺名称，必填

"shop_desc":"四海一家是XXX",//店铺简介，选填

"cover":{//封面图片，必填

url:"",//图片地址

height:"",//图片高度

width:""//图片宽度

},

"thumbnail":{//封面图片缩略图，选填

url:"",//图片地址

height:"",//图片高度

width:""//图片宽度

},

"description":"买一送一",//描述(摘要)，必填

"location":{//地理，必填

"country_name":"中国",//国家名

"province_name":"广东",//省份

"city_name":"深圳",//城市名

"code_name":"南山区",//区域编码或者县区

"town_name":"",//乡名称

"village_name":"",//村名称

"street_name":"深南大道",//街道名称

"street_no_name":"10000号",//街道号

"detail_name":"腾讯大厦13楼"//详细地址

},

"tag":"汽车,速度与激情",//关键词，关键词之间以,做为分割符，必填

"value":1.01,//原价，选填

"price":0.01,//价格，必填

"create_time":"2015-04-1713:25:30",//创建时间，选填

"modify_time":"2015-04-1713:25:30",//修改时间，必填

"start_time":"2015-04-1713:25:30",//发布时间，必填

"end_time":"2015-04-1713:25:30",//发布时间，必填

"hot_level":5,//星级，选填

"status":1//1为上架，0为下架，默认为1，选填

"comment":[

{

comment_text:"第一次抢到沙发。。。",//评论信息

comment_time:"2015-04-3011:11:11",//评论时间

creator:"评论者一"//评论人

}

],

"comment_web_url":"",//web地址，选填

"comment_app_url":"example://activity&id=555",//app页面跳转地址，选填

"genre":"美食",//类型，必填

"offer":"优惠8.8折扣",//优惠信息，选填

"bought_count":100,//购买人数，选填

"image":[

{

url:"",//图片地址

height:"670",//图片高度

width:"670"//图片宽度

}

],

"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。

在AndroidManifest文件中注册intent-filter

对于一个可以展示{app_name}://{page}/{type}/{id}所指向资源的activity添加如下

intent-filter：

使用am指令进行测试

通过如下指令测试调起，如果能够正确地调起页面展示数据则说明intent-filter设置成功。

adbshellamstart-W-a"t."-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对比，标识该请求来源于应用宝