Context Navigation

Changes between Version 3 and Version 4 of price_api_2.2.0

Timestamp:: 10/29/2015 01:58:37 AM (10 years ago)
Author:: oujianqiang
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

price_api_2.2.0

-                      v3
+                      v4
 [[BR]]
 **需求：**[[BR]]
+、；[[BR]]
+**mrobot接口**
+>
+**后端接口**
+>
+**说明**
+>
+**缓存时间**
+>
+**提交方式**
+> GET
+**是否需要登录**
+>
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+||inReview||审核状态||int||0||否||1-是，0-不是||
+**返回**
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+、topic实体新增一个字段 isOfficialPurchasing，用于区分爆料是否支持官方代购；[[BR]]
+**mrobot接口**
+> http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp
+eg：http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp?sectionId=0&pageNo=2&pageSize=20&v=2.2.0[[BR]]
+**后端接口**
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#栏目爆料列表 栏目爆料列表]
+eg：http://best.pconline.com.cn/app/topic/cache/getTopicList.do?pageNo=0&pageSize=20&sectionId=0[[BR]]
+**说明**
+> 根据传入的栏目id，获取对应的爆料列表
+**缓存时间**
+> 300s
+**提交方式**
+> GET
+**是否需要登录**
+> 否
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+||sectionId||栏目id：0 优惠 1 海淘 2 发现 3 晒物 4 经验 5 海淘晒物 6 海淘经验 7 试用体验 8 专题||int||0||是||||
+||pageNo||页数||int||1||是||||
+||pageSize||页面大小||int||10||是||||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+||inReview||审核状态||int||0||否||1-是，0-不是||
+**返回格式**
+> json
+**返回数据**
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+  ,
+    pageNo: 1,
+    pageSize: 20,
+    pageTotal: 2168,
+    total: 43357
+    data:[
+        {//from $topic
+            topicId: 2395585,
+            title: "有钱你就来",  //标题
+            shortTitle: "超值商品推荐"  // 短标题
+            section: 1, // 栏目：0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题
+            topSection: 1  // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验
+            mallName: "京东",  // 电商名称
+            mallId: 1, // 电商id
+            price: "五折对低价199",  // 价格描述
+            pubDate: 13215412512000,  // 发布时间,时间戳 毫秒
+            overdueStatus: 1,  // 是否过期
+            endTime: 13251245121000,  // 优惠截止时间
+            channelId: 12,  // 计数器栏目id
+            imagesForList: "http://www.a.b/a.png",
+            hasCoupon: 0,  // 是否有优惠券，适用于 优惠，海淘
+            cover: "http://www.google.com/1.png",
+            hdCover: "http://www.google.com/1_hd.png",  // 高清图，适用于晒物，经验，试用体验
+            showPicForApp: 1  // 是否白菜价合集
+            createName: "Jason@qq.com",  // 创建者名称
+            createNamePrefix: "Jason",  // 创建者名称，邮箱前缀
+            isOfficialPurchasing: 0  //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】
+        }
+        ...
+    ]
+}
 }}}
 …
 [[BR]]
 **需求：**[[BR]]
+、；[[BR]]
+**mrobot接口**
+>
+**后端接口**
+>
+**说明**
+>
+**缓存时间**
+>
+**提交方式**
+> GET
+**是否需要登录**
+>
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+||inReview||审核状态||int||0||否||1-是，0-不是||
+**返回**
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+}
+}}}
+----------
+=== 1.3商品信息编辑wap页 ===
+[[BR]]
+**需求：**[[BR]]
+、；[[BR]]
+**mrobot接口**
+>
+**后端接口**
+>
+**说明**
+>
+**缓存时间**
+>
+**提交方式**
+> GET
+**是否需要登录**
+>
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+||inReview||审核状态||int||0||否||1-是，0-不是||
+**返回**
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+}
+}}}
+、页面附加信息：新增一个标签字段isOfficialPurchasing，用于标记爆料是否支持代购；[[BR]]
+**mrobot接口**
+> http://mrobot.pconline.com.cn/s-1800/best/cms/topicDetail.xsp?topicId=125405&platform=iOS&v=2.1.0&resVer=21000
+**后端接口**
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#爆料详细信息 爆料详细信息] eg：http://best.pconline.com.cn/app/topic/getTopicInfo.do?topicId=125405&fontSize=17&hd=0 [[BR]]
+> 评论数接口  eg：http://cmt.pconline.com.cn/action/topic/get_data.jsp?url=http://best.pconline.com.cn/discovery_art.jsp?topicId=125405[[BR]]
+**说明**
+> 爆料详情终端页
+**缓存时间**
+> 1800s
+**提交方式**
+> GET
+**是否需要登录**
+> 否
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+||topicId||爆料id||int||0||是||  ||
+||fontSize||字体大小||int||17||是||  ||
+||hd||是否显示高清图：0 否 1 是||int||0||否||  ||
+||platform||平台标识。android平台，platform=android；iOS平台，platform=iOS||String||""||是||  ||
+||v||版本号||String||"0.0.0"||是||  ||
+||resVer||资源包版本号||int||0||是||  ||
+**返回格式**
+> html
+**返回数据**
+html页面，内嵌JSON格式的附加信息，以及点击交互的跳转协议[[BR]]
+附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾[[BR]]
+附加信息：
+||= 爆料类型 =||= 附加信息内容 =||
+||优惠、海淘、发现||#见data1#||
+||晒物、经验||#见data2#||
+{{{
+#data1#包含：
+{
+  topicId: 13253,//爆料id
+  topicType: 1,//0优惠，1海淘，2 发现
+  url: http://best.pconline.com.cn/discovery_art.jsp?topicId=$topic.topicId //用于评论数
+  artUrl:"http://best.pconline.com.cn/youhui/125405.html",//pc地址，用于分享
+  title: $topic.shortTitle + $topic.price + $topic.sectionDesc
+  wxTitle:【今日聚超值_栏目】+$topic.title||topic.shortTitle+"   "+$topic.price（其中栏目为具体的typeName,0,1,2时显示title,3,4时显示为shortTitle）,
+  date: $topic.pubDate
+  author: $topic.createNamePrefix
+  purchasingNum: $topic.purchasingCount.totalCount
+  firstPic: $topic.cover(获取350x350大小的)
+  bestBuyLink:"bestbuy://topic-1.cc",  //直达链接，可能是自定义的协议或者普通的url
+  commentCount:245 //评论数 【V2.1.0需求:新增字段，请求评论数接口获取】
+  commentId:45 //评论id 【V2.1.0需求:新增字段，请求评论数接口获取】
+  iphoneResVer:21000 //模板版本号（iOS请求时返回）
+  androidResVer:21000 //模板版本号（Android请求时返回）
+  isOfficialPurchasing: 0  //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】
+}
+#data2#包含：
+{
+  topicId: 13253, //爆料id
+  topicType: 3,    //3 晒物，4经验
+  url: http://best.pconline.com.cn/discovery_art.jsp?topicId=$topic.topicId
+  artUrl:"http://best.pconline.com.cn/youhui/125405.html",//pc地址，用于分享
+  title: $topic.shortTitle + $topic.price + $topic.sectionDesc
+  wxTitle:【今日聚超值_栏目】+$topic.title||topic.shortTitle+"   "+$topic.price（其中栏目为具体的typeName,0,1,2时显示title,3,4时显示为shortTitle）,
+  date: $topic.pubDate
+  author: $topic.createNamePrefix
+  purchasingNum: $topic.purchasingCount.totalCount
+  firstPic: $topic.cover,(获取350x350大小的)
+  commentCount:245 //评论数 【V2.1.0需求:新增字段，请求评论数接口获取】
+  commentId:45 //评论id 【V2.1.0需求:新增字段，请求评论数接口获取】
+  iphoneResVer:21000 //模板版本号（iOS请求时返回）
+  androidResVer:21000 //模板版本号（Android请求时返回）
+  isOfficialPurchasing: 0  //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】
+}
+}}}
+跳转协议：[[BR]]
+优惠/海淘/发现 详情终端页:[[BR]]
+正文字号的问题，跟前端和设计确认了，设计稿的尺寸到制作稿时要减半，所以正文的大中小字号应该分别为19、17、15
+||=协议=||=参数说明=||=触发事件=||
+||pconlinebestbuy://best-coupon-detail/giftId||giftId：优惠券id||点击爆料详情终端页的"优惠券"内时触发，进入优惠券详情||
+||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 ||
+||pconlinebestbuy://best-shop-list/topicId||topicId：爆料id||点击爆料详情终端页的"有**家商家可代购"时触发，进入商家列表||
+||pconlinebestbuy://best-outer-web/?url={url}||url：代购地址||点击爆料详情终端页底部的"推荐代购商家"时触发，进入商家淘宝商品外链（此处需要计数器，此url尾加对应的类型，计数由app做，url添加尾字符由best提供，代购页面跳转协议中的url后带上#Purchase，商家购买页面跳转协议中的url后带上#GoSeeIt）||
+[[BR]]
+晒物详情终端页:[[BR]]
+||=协议=||=参数说明=||=触发事件=||
+||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 ||
+||pconlinebestbuy://best-outer-web/?url={url}||url：代购地址||点击爆料详情终端页底部的"推荐代购商家"时触发，进入商家淘宝商品外链||
+经验详情终端页:[[BR]]
+||=协议=||=参数说明=||=触发事件=||
+||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 ||
+[[BR]]
+晒物及经验详情页面，头图采用hdCover,按hd=0则取hdCover的400x200尺寸,hd=1则取hdCover的600x300尺寸
+----------
+=== 1.3商品选择wap页 ===
+[[BR]]
+**需求：**[[BR]]
+、；[[BR]]
+**mrobot接口**
+> 无
+**后端接口**
+> http://best.pconline.com.cn/appIntf/goods/showGoods.jsp
+**说明**
+> 商品选择页面
+**缓存时间**
+> 无
+**提交方式**
+> POST
+**是否需要登录**
+> 否
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| topicId || 爆料id || string || "" || 是 ||  ||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+**返回格式**
+> html
+**返回数据**
+> html页面
+操作协议：[[BR]]
+关闭页面点击协议：pcaction://quit-choosing       [[BR]]
+确认商品点击协议：pcaction://finish-choosing/商品outerId   [[BR]]