一、 团购API格式示例
团购API格式示例,接口格式如下:
通过我们的审核后,您的团购信息将会在571的团购页面展示。
联系方式:info#571.com (回复邮件时,请自动将#改为@)
团购信息接口格式示例:(改版后新api样例)
<?xml version="1.0" encoding="utf-8" ?>
<urlset>
<url>
<loc>http://xxx.baidu.com/xxxxxx</loc>
<!-- 商品URLurl 256 bytes [必填]-->
<data>
<display>
<website>美团</website>
<!-- 站点名称 50 bytes [必填]-->
<siteurl>http://xxx.baidu.com</siteurl>
<!-- 站点名称(请填写各城市对应的页面url,如此处应为http://xxx.baidu.com/beijing/) 256 bytes [必填]-->
<city>北京</city>
<!-- 城市名称(城市名称不需要附带省、市、区、县等字,如果是全国范围请指明:全国) 16 bytes [必填] -->
<category>1</category>
<!—-团购分类 1=餐饮美食,2=休闲娱乐,3=生活服务,4=网上购物,13=化妆品,25=电影票,26=烧烤,27=自助餐,28=蛋糕,29=摄影,30=KTV,31=女包,32=酒店,33=美容,34=美发,35=零食,36=火锅,37=健身,38=双人套餐,39=咖啡厅,40=日韩料理,41=下午茶,42=演出,43=游戏币,44=足疗,45=台球,46=漂流,47=体检,48=SPA,49=养生,50=瑜伽,51=服饰,52=家居,53=首饰,54=数码,55=图书 4 bytes [如果不能确定分类,值可以为,字段必须有] -->
<dpshopid>507810, 2218060</dpshopid>
<!—-团购商家的大众点评shopid,多个以英文逗号分隔,512 bytes [值可以为,字段必须有]-->
<range>三里屯,中关村</range>
<!—-团购商家的大概方位,多个以英文逗号分隔,按照填写顺序显示商家,512 bytes[值可为空,字段必须有]-->
<address>北京市三里屯XX路XX大厦,中关村YY路XX广场</address>
<!—-团购商家的具体位置,多个以英文逗号分隔,按照填写顺序显示商家,2048 bytes[值可为空,字段必须有]-->
<major>1</major>
<!--同一个城市如果推出多个团购商品,需要设置其中一款商品为今日主打商品,主打商品的这个字段是为1,非主打商品为0, 1bytes [值可为空,字段必须有]-->
<pid>189</pid>
<! -- 项目永久唯一ID ,字符串,这个ID是您网站内部的ID,保证历史上每个团购都有不同的 ID,每个团购ID不变,即使url变化,比如直接用数据库中的id,或者进行一些处理 [选填]-->
<title>原价188元的“玛雅蛋糕”仅售49元!</title>
<!-- 商品标题 512 bytes[必填] -->
<product>玛雅蛋糕!</product>
<!-- 商品名称,与产品铭牌名称一致 255 bytes[选填] -->
<image>http://maya.xxx.com/xxx.gif</image>
<!-- 商品图片url 256 bytes [必填] -->
<startTime>1275926400</startTime>
<!-- 商品开始时间 10 bytes [必填]-->
<endTime>1291910399</endTime>
<!-- 商品结束时间 10 bytes [必填]-->
<value>188.00</value>
<!-- 商品原价 12 bytes [必填]-->
<price>49.00</price>
<!-- 商品现价 12 bytes [必填]-->
<rebate>2.6</rebate>
<!-- 商品折扣 6 bytes [必填]-->
<bought>100</bought>
<!-- 已购买人数 10 bytes [必填]-->
</display>
</data>
</url>
</urlset>
二、 常见问题解答
1.API接口检验
在提交接口前,请参照API接口说明检查个字段是否符合要求,是否包含非法字符,不要包含<,>,\r,\n,单引号,双引号,[,]等这些符号。 建议对照meituan(http://www.meituan.com/api/571.xml)的接口仔细检查格式。点此进行接口检测
2.如何在接口中添加多个城市
在一个xml文件中,用…添加多个城市,请参考美团的例子:http://www.meituan.com/api/deals/hao123。 如果团购项目是面向【全国】的,只需要把city字段的值写成【全国】,例如全国,系统会自动给每一个开放的团购城市添加一个该团购项目。
3.数据更新的问题
每次更新数据的时候,startTime这个字段的值要比上次更新时该字段的值要大,譬如加1,例如之前startTime是【1282060800】,更新数据的时候把startTime变为【1282060801】,只有这样才能保证输出的是最新的数据。
4.图片规格限制
接口中提供给571的团购图片,请提供一张尺寸为267 x 160的图片(如长宽比例不同,则长度不能超过267,宽度不能超过160),压缩控制在15k-30k(保证图片质量和色彩)。