Changes between Version 10 and Version 11 of price_api_2.1.0

Timestamp:

08/27/2015 03:44:16 PM (11 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.1.0

@@ -37 +37 @@
 
 == 1 首页模块 ==
-=== 1.1 首页列表数据接口 === 
-**（V2.1.0未处理，处理后请修改或去掉此括号内容）**
+=== 1.1 首页精选列表 === 
+**需求：**[[BR]]
+1、listIndex数组中的爆料实体，新增bigPicModel字段；[[BR]]
+2、返回数据新增置底位爆料lastIndex；[[BR]]
+
+
+**原mrobot接口**
+
+>http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp  [[BR]]
+>eg: http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp?pageNo=1&pageSize=10&v=201 [[BR]]
+
 
 **mrobot接口**
 
->http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp  [[BR]]
->eg: http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp?pageNo=1&pageSize=10&v=201
+>【mrobot开发补充】
+
 
 **后端接口**
@@ -49 +58 @@
 >[http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/facade 首页数据接口] eg：http://best.pconline.com.cn/app/facade/cache/index.do?pageNo=1&pageSize=20 [[BR]] 
 >[http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/11_focusImage 焦点图] eg：http://best.pconline.com.cn/app/focus/cache/listFocus.do?topicTypeId=0&type=0&v=201 [[BR]]
->【置底爆料：待补充】【V2.1.0需求】
+>【置底位爆料：待补充】【V2.1.0需求】[[BR]]
+
 **说明**
 
-> 获取推荐首页列表数据 + 焦点图（另外的接口，当pageNo为1时返回）+ 置底爆料
+> 获取推荐首页列表数据 + 焦点图（另外的接口，当pageNo为1时返回）+ 置底爆料[[BR]]
+
 
 **提交方式**
 
-> GET
+> GET[[BR]]
+
 
 **参数**
@@ -90 +102 @@
         ...
     ]
-    listIndex:[//基本列表数据
+    listIndex:[//原始列表数据
         {
             type:1 // 1 爆料
@@ -110 +122 @@
                 cover: "http://www.google.com/1.png",
                 hdCover: "http://www.google.com/1_hd.png",  // 高清图，适用于晒物，经验，试用体验
-                showPicForApp: 1  // 是否白菜价合集
-                【V2.1.0需求】【新增字段：晒物/经验的显示方式，1-横图模式（大图模式），0-普通爆料模式（小图模式）】
+                showPicForApp: 1,  // 是否白菜价合集
+                bigPicModel: 1// 晒物/经验的显示方式，1-横图模式（大图模式），0-普通爆料模式（小图模式）【V2.1.0需求:新增字段】
             }
         }
@@ -170 +182 @@
                 hdCover: "http://www.google.com/1_hd.png",  // 高清图，适用于晒物，经验，试用体验
                 showPicForApp: 1  // 是否白菜价合集
+                bigPicModel: 1// 晒物/经验的显示方式，1-横图模式（大图模式），0-普通爆料模式（小图模式）【V2.1.0需求:新增字段】
             }
         }
@@ -181 +194 @@
 
 === 1.2 单篇爆料、晒物、经验、体验报告、专题终端页（Web） === 
-**（V2.1.0未处理，处理后请修改或去掉此括号内容）**
+
+**需求：**[[BR]]
+1、附加信息新增评论数字段commentCount；[[BR]]
+
+
+**原mrobot接口**
+> http://mrobot.pconline.com.cn/s-1800/best/cms/topicDetail.xsp?topicId=125405
 
 **mrobot接口**
-> http://mrobot.pconline.com.cn/s-1800/best/cms/topicDetail.xsp?topicId=125405
+
+>【mrobot开发补充】
 
 **后端接口**
@@ -230 +250 @@
   firstPic: $topic.cover(获取350x350大小的)
   bestBuyLink:"bestbuy://topic-1.cc",  //直达链接，可能是自定义的协议或者普通的url
-  commentCount:245 //评论数 【V2.1.0需求】请求评论数接口获取
+  commentCount:245 //评论数 【V2.1.0需求:新增字段，请求评论数接口获取】
 }
 
@@ -245 +265 @@
   purchasingNum: $topic.purchasingCount.totalCount
   firstPic: $topic.cover,(获取350x350大小的)
-  commentCount:245 //评论数 【V2.1.0需求】请求评论数接口获取
+  commentCount:245 //评论数 【V2.1.0需求:新增字段，请求评论数接口获取】
   
 }
@@ -277 +297 @@
 
 === 2.1 获取用户扩展信息 === 
-**（V2.1.0未处理，处理后请修改或去掉此括号内容）**
+**需求：**[[BR]]
+1、当前线上接口返回的couponNum字段是所有（可用和过期）优惠券的总数，需修改为只返回“可用”优惠券的数目；[[BR]]
+
+**mrobot接口**
 
 > http://mrobot.pconline.com.cn/s/best/my/getUserExtend.xsp
@@ -308 +331 @@
       topicNum: 1,//我的爆料数
       favNum: 10,//我的收藏数
-      couponNum: 2//我的可用优惠券数【V2.1.0需求】
+      couponNum: 2//我的可用优惠券数【V2.1.0需求:字段值修改】
     }
 }
@@ -318 +341 @@
 
 === 2.2 推送设置内容定制列表 === 
-**（V2.1.0未处理，处理后请修改或去掉此括号内容）**
+**需求：**[[BR]]
+1、返回数据data数组中的每一项需返回是否已订阅的状态；[[BR]]
+
+**原mrobot接口**：
+> http://mrobot.pconline.com.cn/s-1800/best/cms/listTopicType.xsp
 
 **mrobot接口**
 
-> 【待补充】
+> #mrobot补充#
 
 **后端接口**
 
-> 【待补充】
+> #mrobot待补充#
 
 **说明**
@@ -334 +361 @@
 **提交方式**
 
-> 【待定】
+> #mrobot跟后台确认并补充#
 
 **参数**
+#需mrobot跟后台确认，如有变化则修改#
 
 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
 ||level||1 一级分类 2 二级分类||int||0||否||
 ||parentId||上级分类id||int||0||否||
-|| addition ||上级分类id|| String ||""||是||
+|| addition ||token（需mrobot确认是否要加密）|| String ||""||是||
 || device ||设备类型 0 iOS 1 android|| int ||0||是||
 
@@ -350 +378 @@
   status: 1,
   msg: "请求成功"
-  data: {//from $topicType
-    typeId: 1,
-    name: '数码家电',
-    level: 1  // 分类等级,
-    open（字段名待后端接口完成后再修改）: 1  // 是否已订阅 1-是  0-否【V2.1.0需求】
-  }
+  data:[
+    {//from $topicType
+      typeId: 1,
+      name: '数码家电',
+      level: 1  // 分类等级,
+      subscribed: 1  // 是否已订阅 1-是  0-否【V2.1.0需求:新增字段】
+    },
+    ...
+  ]
 }
 }}}
@@ -387 +418 @@
 **返回**
 
-> # mrobot补充 #
+> #mrobot补充#
 
 ----------
+== 4 爆料详情终端页优化 ==
+  备注：为进一步加快爆料详情终端页的传输速度，将终端页拆分成css、js和html主体两个部分，其中css、js放客户端本地，html主体由mrobot接口给出；客户端需支持在线更新css、js功能  [[BR]]
+  资源更新配置地址：pconlinebestbuy_android_auto_update.json、pconlinebestbuy_iphone_auto_update.json
+  [[BR]]请求参数：新增如下请求参数
+                  platform   //平台标识。android平台，platform=android；iOS平台，platform=iOS[[BR]]
+                  v=210  //版本号[[BR]]
+                  resVer //资源包版本号。resVer=25001，此版本号由app版本号和资源包迭代版本构成，如资源包第一版，resVer=25001；资源包第二版，resVer=25002，如此类推