团购API规范 - 搜狗网址导航

搜狗团购导航API规范

一、 搜狗团购API格式示例

对于各团购站提交的API接口，我们将进行详细审核，审核通过后才会予以收录。

搜狗团购API格式示例，接口格式如下:

<?xml version="1.0" encoding="utf-8" ?> <urlset> <url> <loc>http://www.lashou.com/deal/beijing/27325.html</loc> <!-- 商品URLurl 256 bytes ［必填］--> <data> <display> <website>拉手网</website> <!-- 站点名称 50 bytes ［必填］--> <siteurl>http://www.lashou.com/beijing</siteurl> <!-- 站点名称（请填写各城市对应的页面url，如此处应为http://xxx.baidu.com/beijing/） 256 bytes ［必填］--> <city>北京</city> <!-- 城市名称（城市名称不需要附带省、市、区、县等字，如果是全国范围务必请指明：全国） 16 bytes ［必填］ --> <category>1</category> <!—-团购分类 1=餐饮美食，2=休闲娱乐，3=美容保健，4=网上购物, 4 bytes [如果不能确定分类，值可以为0，字段必须有] --> <address>北京市中关村丹棱街甲1号ECMall欧美汇购物中心6楼</address> <!—-团购商家的具体位置（机器采用搜狗地图识别，然后展现在团购地图页面），多个以英文逗号分隔，按照填写顺序显示商家,1024 bytes［值可为空，字段必须有］--> <major>1</major> <!--同一个城市如果推出多个团购商品，需要设置其中一款商品为今日主打商品，主打商品的这个字段是为1,非主打商品为0, 1bytes [值可为0，字段必须有]--> <title>仅售190元再返38元拉手返利！金钱豹携拉手再度狂卷而来！</title> <!-- 商品标题 512 bytes［必填］ --> <image>http://s1.lashouimg.com/lasho_pic/go/00/00/02/73/27325</image> <!-- 商品图片url 256 bytes ［必填］ --> <startTime>1300896000</startTime> <!-- 商品开始时间 10 bytes ［必填］--> <endTime>1301155200</endTime> <!-- 商品结束时间 10 bytes ［必填］--> <value>238.00</value> <!-- 商品原价 12 bytes ［必填］--> <price>190.00</price> <!-- 商品现价 12 bytes ［必填］--> <rebate>8</rebate> <!-- 商品折扣 6 bytes ［必填］--> <bought>168</bought> <!-- 已购买人数 10 bytes ［必填］--> </display> </data> </url> <url> ... </url> </urlset>

二、 常见问题解答

1. API接口检验

在提交接口前，请参照API接口说明检查个字段是否符合要求，是否包含非法字符，不要包含<,>,\r,\n,单引号,双引号,[,]等这些符号。 含中文的字段尽量使用<![CDATA[...]]>包裹。

 

2. 如何在接口中添加多个城市

在一个xml文件中，如果团购项目是面向【全国】的，只需要把city字段的值写成【全国】，系统会自动给每一个开放的团购城市添加一个该团购项目。 如果团购项目已经标记为【全国】的，尽量不要在其它城市重复添加该项目。

 

3. 数据更新的问题

每次更新数据的时候，startTime这个字段的值要比上次更新时该字段的值要大，譬如加1，例如之前startTime是【1282060800】，更新数据的时候把startTime变为【1282060801】，只有这样才能保证输出的是最新的数据。

对于长期团购，尽量在每日的API中更新内容，避免出现过期。

 

4. 图片规格限制

接口中提供给搜狗团购导航的团购图片，请提供一张长宽比例约为8:5、尺寸约为280 x 175的图片，在保证图片质量和色彩的前提下，图片大小压缩控制在15k-30k左右。

 

三、 不规范API说明

各团购站提交的API，我们会在提交时进行严格审核；开始收录后，也会定期进行机器和人工检查。对于不规范的团购API，将不予通知直接删除。不规范情形举例：

 

1、商品重复

例如：在同一个城市下，出现两款或多款重复团购；已经被标记为【全国】的团购，在其它城市又被标记为【XX城市】进行重复展现。商品重复会影响API权重和展现。

 

2、实际城市与city标记不符合

例如：商品实际为全国性质的邮寄类商品，却刻意标记为【北京】【上海】等地方城市，不符合商品的真实信息。 实际为【北京】的本地服务商品，却在【上海】也被展现。

 

3、主打商品

没有设定major=1的商品，会影响商品的排序和展现；重复多次设定无实际意义的major=1内容，也会影响API排序和展现。

 

4、商品开始时间

startTime距当前时间已经超过了10天。即把所有历史商品都积累到一起，刻意堆积团购商品的数量。没有及时更新商品开始时间会影响API权重和展现。

 

5、伪造团购属性

对API中团购的属性（包括标题、描述、图片、价格、时间、折扣、购买人数等）进行伪造、堆砌，即API信息与最终展现内容不符，API中的信息为虚假信息，或者团购项目实际无意义或不存在。伪造团购信息将直接被停止收录。

 

如果有其它疑问，请到意见反馈页面填写具体内容并提交