《2345团购导航合作API操作手册.doc》由会员分享，可在线阅读，更多相关《2345团购导航合作API操作手册.doc（12页珍藏版）》请在三一文库上搜索。
1、2345团购导航合作api操作手册2345团购导航合作api手册v4.0一、API正文字体蓝色为注释性语句，红色为注意事项。API正文如下注释ver=4.0商品URL网站名称城市一级分类商品标题商品图片地址商品开始时间商品结束时间商品原价商品现价折扣购买人数消费开始时间消费结束时间收藏人数商品描述商品提示底层分类商户详细地址商户缩略地址商户电话公交信息商家名称大众点评网ID九寨沟化妆品品牌化妆品功效第1行: API 的版本号，必须放在第一行第2行: 起始分隔符第3行: varchar(255), 网站地址*必填。原API2.0标签。第4行: varchar(100), 网站名称*必填。原API
2、2.0标签。第5行: varchar(100), 城市名称*必填。原API2.0标签。第6行: 分类类别*必填。只能从下列分类中选择一个：餐饮美食/生活娱乐/网上购物/旅游酒店/化妆品。原API2.0标签。第7行: varchar(255), 商品的标题*必填。原API2.0标签。第8行: varchar(255), 商品图片链接地址*必填，必须以http:/开头. 扩展名必须为jpg,gif或png。原API2.0标签。第9行: int(11), 团购开始时间*必填，指时间戳时间,必须是10位的数字。原API2.0标签。第10行: int(11), 团购结束时间*必填，指时间戳时间,必须是1
3、0位的数字。原API2.0标签。第11行: decimal(15, 2), 原价*必填，必须为数字可以带小数点。原API2.0标签。第12行: decimal(15, 2), 团购价*必填，必须为数字可以带小数点。原API2.0标签。第13行: varchar(50), 折扣*必填，数字可带小数点，小数点保留2位，第三位向第二位四舍五入若无填0。原API2.0标签。第14行: int(11), 购买人数*必填，必须为0或正整数。原API2.0标签。第15行: int(11), 消费开始时间*必填，必须是10位的数字。原API2.0标签。第16行: int(11), 消费结束时间*必填，必须是1
4、0位的数字，若无可以填0。原API2.0标签。第17行:空行第18行:空行第19行: int(11), 收藏人数*必填，必须为0或正整数。原API2.0标签。第20行:空行第21行: varchar(255), 商品描述选填，纯文字不超过255个字。商品的具体形态，非商品标题。比如衣服款式尺寸。第22行: varchar(255), 商品提示信息 选填，纯文字不超过255个字。消费截止时间，消费特别提醒等商家重要信息。第23行: varchar(120),底层分类,即在贵站中的最后一级别分类，如有三级分类请填写三级分类，如没有请填二级分类。第24行: varchar(60), 目前已经采用程序
5、自动判别地址归商圈,填空第25行: varchar(255), 详细地图地址*必填。省略”省，城市，区” 只填写街道，门牌号后的数字。若城市为“全国”这里请留空。第26行: varchar(100), 简短地图地址*与上一行填写同样内容,若城市为“全国”这里请留空。原API2.0标签.第27行: varchar(60), 商店地址的联系电话*选填。原API2.0标签.第28行: varchar(60), 公交线路*选填，用于后期开发公交沿线搜索。原API2.0标签.第29行: varchar(120), 原API2.0标签第30行: varchar(120), 商家名称，非必填字段没有请留空。
6、原API3.0标签第31行: int(11), 该商品的大众点评网ID， 非必填字段没有则填0。原API3.0标签第32行: varchar(120),旅游目的地。非必填字段 新API4.0标签第33行: varchar(120), 化妆品品牌。非必填字段 新API4.0标签第33行: varchar(120), 化妆品功效。非必填字段 新API4.0标签第35行: varchar(255), 商品的备注字段3*留空。以后扩充功能使用。原API2.0标签第36行: varchar(255), 地图的备注字段3*留空。以后扩充功能使用。原API2.0标签第37行:结束符二、API举例范例说明：v
7、er=4.0http:/ X团 上海餐饮美食 仅售36.9元!英国女王、戴安娜王妃最爱:原价85元皇家御用CYCLAX绿茶面颈滋润霜!神奇抹去颈部细纹,网上超爆人气,狂卖http:/ 1299551333150.00 50.00 3.0 2221299551333 1299551333 200商品描述商品提示六一淮海路北京西路235弄38号广汇广场 北京西路235弄38号广汇广场 021-435966 021-435833三、各字段名说明字段名字段说明属性限制必填项商品url描述详细信息页面的ULR地址（新增商品的url不要覆盖老的商品的url）URL256B是站点名称站点名称文本50B是城市
8、城市名称（城市名称不需要附带省、市、区、县等字，如果是全国范围请指明：全国）注意：只能填写一个城市名称文本16B是一级分类分为“餐饮美食”“生活休闲”“旅游酒店”“网络购物”“化妆品”文本2B是细分类指团购商品一级类目对应的二级类目。注意：每个商品只有一个细分类，具体参见API分类说明文本16B是商家的大众点评网ID团购商家的大众点评shopid，文本512B否商圈名称团购商家的大概方位文本512B否商家的详细地址团购商家的具体位置，多个以英文逗号分隔，按照填写顺序显示商家文本512B否（本地类必填）是否主打可填写1或者0,1为主打，0为非主打文本2B是商品标题商品标题（如：原价188元的玛雅
9、蛋糕仅售49元！）文本512B是商品图片地址商品图片url 。图片大小宽*高为266*166,图片大小要小于15KURL256B是开始时间团购商品开始时间。（如：1275926400）文本10B是结束时间团购商品结束时间。（如：1291910399）文本10B是消费开始时间消费商品开始时间。（如：1275926400）文本10B是消费结束时间消费商品结束时间。（如：1291910399）文本10B是商品原价商品原价文本12B是现价商品现价文本12B是折扣商品折扣文本6 B是购买人数已购买人数文本10B是商品描述商品名称准确描述，如 铅笔盒文本512B否（网购类必填）消费提示商家的消费提示文本5
10、12B否商家名称商家的准确描述，如青鸟健身、必胜客文本512B否（本地类必填）商家电话商家的电话号码，多个号码文本50B否商家公交信息商家的公交信息文本50B否收藏人数收藏人数多少文本50B是三级分类商品的三级分类，请参见文档附表文本50B否商户详细地址填写商户详细地址文本512B否商户缩略地址填写商户缩略地址文本512B否四、API分类说明五、API制作注意事项1、每个产品由开始结束，其中间包含36个字段信息，每个字段信息一行，所以每个产品中间务必只有36行，每行内容最后请用回车换行符(rn)结束，每行数据的内容中如果有回车换行符(rn、r、n)请替换成字符串。2、所有非数字选填项没有则为空
11、， 数字的选填项没有则填03、请在文件开头加上ver=版本号（目前为4.0）,不加版本号的API将视为无效API。4、严格按照标准制作可以帮助您更好更快的抓取商品,所以请严格对照标准来制作api,认真填写每一行数据.由于导航站每日编辑处理的数据众多,因为格式错误或api错误造成图片无法显示的情况,我们会予以删除.所以会影响您的广告及收录质量，请您认真对待API的内容.5、图片无法抓取的情况,主要有以下几个方面的原因:图片地址必须为绝对路径,请不要使用相对地址扩展名必须为jpg,gif或png,请不要使用其他后缀名,图片不要太大,2345的图片标准格式大小为440X282,请在保证清晰的情况下保
12、持大于等于此比例，图片质量越小抓取速度越快。服务器限制了防盗链,防抓取程序,我们无法抓取到服务器不稳定.请联系机房维护或使用稳定的服务器.,6、API里各城市列表第一个商品为主推，如只有全国一个城市标签则所有商品列表中的第一个为主推。各地方城市的本地服务的产品在API里的权重要要高于全国商品的权重。7、API当天如果从产品列表里更换主推，一定要保证产品链接，图片链接，产品标题及描述与列表中的不同（等同于重新编辑商品），否则会导致更换的主推无法显示。8、老版本的API会对 !CDATA 进行过滤。 但2.0的初衷是 为了 提高采集速度 所以才会有去掉标签的这种形式出现 ,包括刚才提的!CDATA
13、 这种的过滤 我们也知道可以通过str_replace函数或其他函数来实现的， 但这样还是会影响我们的采集速度！ 使用函数过滤花的时间不会很多，但商品数量一多过滤也会造成采集速度的变慢！ 9、每行数据最大不要超过2048字节.10、网站对采集API做了一次过滤操作， 同一城市下如果有 标题，图片地址或商品链接相同的商品， 程序会认为是已经存在的 商品。 新商品将不会被采集到， 只更新原来存在的那个商品的 收藏数，截止时间和购买人数等。 如果你们的商品有提前下架或 结束需 要重新在API中更新下该商品的消费结束时间， 否则2345团购和团购网站的商品会造成不同步。 如果你们在2345的商品如果要下架，只要API中再次 抓取时的那个商品消费结束时间 填一个比当前时间早的时间就行！或者商品不在API中显示也会自动下架。六、API常见问题解答Q1:站点链接siteurl填写的是网站主页的链接吗？A：不是，siteurl填写的是网站在该城市站点下的url，如：http:/ 第 12 页 共 12 页 整理人：王远成