Changes between Version 3 and Version 4 of price_api_2.3.0

Timestamp:

12/04/2015 02:59:18 PM (10 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.3.0

@@ -38 +38 @@
 
 
+== 1 功能相关 ==
 === 1.1 首页精选列表数据接口（M） === 
 （未完成）[[BR]]
@@ -44 +45 @@
 
 {{{
-请求参数的变动：新增3个参数
-1）platform：平台，传”iOS”或”Android”；
+请求参数变动：新增3个参数
+（无论是get请求还是post请求，都在url上加）
+1）platform：平台，传”ios”或”android”；
 2）v：app版本号，如2.3.0；
-3）inReview=1（Android不传）；
-
-返回参数的变动：
+3）inReview=1（Android端不传）；
+
+
+返回参数变动：
 如果是来自iOS的请求，则在Topic类型的实体，新增2个字段：
 1、爆料简介；
@@ -187 +190 @@
 
 {{{
-请求参数的变动：
+请求参数变动：
 1、sectionId参数新增1个取值：
-1）sectionId=100[后端已提供]时，请求属于“一键购”的海淘列表数据。
+1）sectionId=100[后端已支持]时，请求属于“一键购”的海淘列表数据。
 
 2、新增3个筛选条件的参数：
@@ -196 +199 @@
 3）精彩推荐；
 
-3、新增3个用于控制的参数：
-1）platform：平台，传”iOS”或”Android”；
+3、新增3个用于控制的参数（无论是get请求还是post请求，都在url上加）
+1）platform：平台，传”ios”或”android”；
 2）v：app版本号，如2.3.0；
-3）inReview=1（Android不传）；
-
-
-返回参数的变动：
-如果是来自iOS的请求，则在Topic类型的实体，新增2个字段：
-1、爆料简介；
-2、爆料正文（正文不带图片，不带html标签，字数较多[标准由产品定]则截取）；
-
-
-修改图片点击的协议：新增一个参数：
+3）inReview=1（Android端不传）；
+
+
+返回参数变动：新增3个参数
+1、新增一键购开关控制字段，用于控制【一键购】列表顶部的文案是否显示；
+2、如果是来自iOS的请求，则在Topic类型的实体，新增2个字段：
+1）爆料简介；
+2）爆料正文（正文不带图片，不带html标签，字数较多[标准由产品定]则截取）；
+
+
+图片点击的协议的变动：新增一个参数：
 1、图片链接imgUrl
 
@@ -216 +220 @@
 topicId：爆料id
 curIndex：所点击图片的序号（从0算起）
-imgUrl：所点击图片的地址链接，其中特殊字符需要url编码
+imgUrl：所点击图片的地址链接，其中特殊字符需要url编码【新增】
 }}}
 
@@ -360 +364 @@
 **需求：**[[BR]]
 {{{
-请求参数的变动：新增3个参数
-1）platform：平台，传”iOS”或”Android”；
+请求参数变动：新增3个参数
+（无论是get请求还是post请求，都在url上加）
+1）platform：平台，传”ios”或”android”；
 2）v：app版本号，如2.3.0；
-3）inReview=1（Android不传）；
-
-返回参数：
+3）inReview=1（Android端不传）；
+
+
+返回参数变动：
 如果是来自iOS的请求，则在Topic类型的实体，新增2个字段：
 1、爆料简介；
@@ -466 +472 @@
 
 {{{
-返回数据的变动：
+返回数据变动：
 1、【优惠】、【海淘】2类的爆料终端页正文内容：
-1）新增“可能喜欢”的爆料入口，并加上跳转协议；
-2）新增“内容标签”，加上点击协议；
-3）新增该爆料相关的优惠券页面入口按钮，加上点击协议；
+1）新增“可能喜欢”的爆料入口，并加上跳转协议（跳至 爆料终端）；
+2）新增“内容标签”，加上点击协议（查看 搜索结果）；
+3）新增该爆料相关的优惠页面入口按钮，加上点击协议（查看 爆料相关优惠信息）；
 
 2、【发现】类的爆料终端页正文内容：
-1）新增“可能喜欢”的爆料入口，并加上跳转协议
+1）新增“可能喜欢”的爆料入口，并加上跳转协议（跳至 爆料终端）；
 
 3、【晒物】、【经验】2类的爆料终端页正文内容：
-1）新增内容标签，加上点击协议；
-
+1）新增内容标签，加上点击协议（查看 搜索结果）；
 }}}
 
@@ -603 +608 @@
 
 
-=== 1.6 爆料关联的优惠券（M） ===
+=== 1.6 爆料关联的优惠信息（M） ===
 （未完成）[[BR]]
 
 **需求：**[[BR]]
-新接口[[BR]]
+{{{
+新接口
+返回该篇爆料关联的优惠券信息。
+ps：mrobot请求应用后台提供优惠码接口和优惠券接口并合并数据，返回数据的data里返回对应的2个数组，优惠码在前。
+}}}
+
 
 **mrobot接口**
@@ -623 +633 @@
 **说明**
 
-> 返回该篇爆料关联的优惠券信息
+> 返回该篇爆料关联的优惠信息
 
 **缓存时间**
@@ -652 +662 @@
 ----------
 
-=== 1.7 优惠券终端页（M） ===
+=== 1.7 优惠券列表（M） === 
 （未完成）[[BR]]
 
 **需求：**[[BR]]
-补充正文内容：领取优惠券花费的钻石数。
+{{{
+请求参数变动：新增3个参数
+（无论是get请求还是post请求，都在url上加）
+1）platform：平台，传”ios”或”android”；
+2）v：app版本号，如2.3.0；
+3）inReview=1（Android端不传）；
+
+返回数据变动： gift实体里新增1个字段
+1、所需钻石数；
+}}}
+
+**mrobot接口**
+
+> http://mrobot.pconline.com.cn/s-300/best/gift/listGift.xsp
+
+**后端接口**
+
+> http://best.pconline.com.cn/app/gift/cache/listGift.do
+
+**后端接口文档**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/05_gift#礼品列表 礼品列表]
+
+**说明**
+
+> 分页获取礼品列表，传入type为礼品的类型进行查找
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||type||礼品类型： 1 礼品卡 2 实物礼品 3 优惠券||int||1||否||
+||mallId||电商id，0表示查找所有||int||0||否||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    {//from $gift
+        couponId: 123,  // 优惠券Id
+        giftId: 1,  // 礼品Id
+        giftName: "京东卡",
+        needScore: 10, //所需积分
+        needGold: 2,//所需金币
+        mallId:  12,  // 电商Id
+        mallName: '京东',  // 电商名称
+        imageUrl: "http://a.cn/1.png",  // 图片
+        createTime: 13251245124000,  // 创建时间
+        disCount: "满400减20",  // 优惠券额度
+        expiryDate: 13621321521000,  // 有效期
+        remainingDay:2  // 当前时间距离优惠券过期的天数 
+        expiry: 1  // 是否有效  true 有效  false 过期
+    },
+    ...
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift]
+
+----------
+
+=== 1.8 优惠券终端页（M） ===
+（未完成）[[BR]]
+
+**需求：**[[BR]]
+{{{
+正文内容变动：
+1、领取优惠券花费的钻石数
+
+附件信息变动：
+1、增加领取优惠券需要花费的钻石数
+}}}
+
 
 **mrobot接口**：
@@ -705 +806 @@
 ----------
 
-=== 1.8 领取优惠券 === 
+=== 1.9 领取优惠券 === 
 （未完成）[[BR]]
 
@@ -768 +869 @@
 
 
-=== 1.9 提交订单 ===
+=== 2.0 商品选择wap页（M） ===
+（未完成）[[BR]]
+
+**需求：**[[BR]]
+{{{
+页面内容变动：
+1、【一键海淘】功能开放时，页面出商品选择页；
+2、【一键海淘】功能关闭时，页面出信息提示页；
+}}}
+
+**mrobot接口**
+
+> http://mrobot.pconline.com.cn/x/best-best/buy/appIntf/goods/showGoods.jsp?topicId=162832
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/goods/showGoods.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/goods#商品选择 商品选择]
+
+**说明**
+
+> 商品选择页面
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 否
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| topicId || 爆料id || string || "" || 是 ||  ||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+
+**返回格式**
+> html
+
+**返回数据**
+
+> html页面
+
+操作协议：[[BR]]
+关闭页面点击协议：pcaction://close [[BR]]
+确认商品点击协议：pcaction://finish-choosing?outerId={商品outerId}        （不直接采用页面跳转协议，因为进入订单确认页需要先登录）     [[BR]]
+
+
+----------
+
+
+=== 2.1 提交订单 ===
 （未完成）[[BR]]
 
@@ -842 +1002 @@
 
 
-=== 2.0 订单信息 ===
+=== 2.2 订单信息 ===
 （未完成）[[BR]]
 
@@ -889 +1049 @@
 {{{#!java
 
+}}}
+
+
+----------
+
+
+== 2 控制相关 ==
+
+=== 2.1 url添加控制参数 === 
+（移动开发添加）[[BR]]
+
+**需求：**[[BR]]
+
+{{{
+非提交数据的接口，特别是列表接口，请求参数添加3个控制参数
+（无论是get请求还是post请求，都在url上加）
+1）platform：平台，传”ios”或”android”；
+2）v：app版本号，如2.3.0；
+3）inReview=1（Android端不传）
 }}}