Changes between Version 68 and Version 69 of price_api_2.2.0

Timestamp:

11/24/2015 05:43:49 PM (10 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.2.0

@@ -772 +772 @@
 
 
+=== 1.12 首页列表数据接口（M） === 
+**(接口已完成，请连开发机进行测试)**[[BR]]
+
+**需求：**[[BR]]
+1、topic实体新增一个字段 isOfficialPurchasing，用于区分爆料是否支持官方代购；[[BR]]
+
+>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
+
+**后端接口**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/facade 首页数据接口] [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/11_focusImage 焦点图]
+> http://best.pconline.com.cn/app/facade/cache/index.do?pageNo=1&pageSize=20 [[BR]]
+> http://best.pconline.com.cn/app/focus/cache/listFocus.do?topicTypeId=0&type=0&v=201
+**说明**
+
+> 获取推荐首页列表数据 + 焦点图（另外的接口，当pageNo为1时返回）
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||v||版本号||int||0||否||
+
+**返回**
+
+{{{#!java
+{
+    status: 1, 
+    msg: "请求成功",
+    pageNo: 1,
+    pageSize: 20,
+    pageTotal: 2168,
+    total: 43357,
+    focus: [//焦点图
+        {//from $focusImage
+     focusImageId: 12,
+    typeId: 爆料类型Id
+    imageUrl: "http://img.pconline.com.cn/7.jpg",  // 焦点图
+    seq: 1,
+    positionIndex: 1,  // 0 app端焦点图、1 wap端焦点图、2 pc端首页焦点图、3 pc端海淘焦点图、4 PC端晒货焦点图、5 PC端经验焦点图、6 WAP端首页焦点图、7 wap端海淘焦点图、8 wap端发现焦点图、9 wap端晒物焦点图、10 wap端经验焦点图
+    focusTitle: "现货直接买!iPhone6 Plus 64G三网通5K1",  // 标题
+    topicId: 125,  // 爆料id
+    sectionType: 1  // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验
+    url: "http://a.c.com/1.do",  // pc端焦点图跳转url,ps:该字段有数据时才显示，无数据时不显示
+    createAt： 136521542140000  // 创建时间
+        }
+        ...
+    ]
+    listIndex:[
+        {
+            type:1 // 1 爆料
+            value:{//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  // 是否白菜价合集
+                isOfficialPurchasing: 0  //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】
+            }
+        }
+        {
+            type:2 // 2 推荐位
+            value:{//from $adPosition
+                    adId: 51,
+                    adTitle: "好东西哇",
+                    price: "12块包邮",
+                    imageUrl: "http://img.pconline.com.cn/7.jp",
+                    topicId: 23412
+                    section: 1, // 栏目：0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题
+                    topSection: 1  // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验
+                    url: "http://g.pconline.com.cn/a/73727.html",  // 跳转链接
+                    urlType: 1,  // 1 爆料  2 网页,
+                    seq:3  // 排序，插入到首页的位置
+            }
+        }
+        {
+            type:4 // 4 优惠券
+            value:{//from $gift
+                giftId: 1,  // 礼品Id
+                name: "京东卡",
+                needScore: 10, //所需积分
+                needGold: 2,//所需金币
+                mallId:  12,  // 电商Id
+                mallName: '京东',  // 电商名称
+                imageUrl: "http://a.cn/1.png",  // 图片
+                imgPath260x130："",//260x130图片
+                discount: "满400减20",  // 优惠券额度
+                createTime: 13251245124000,  // 创建时间
+                expiryDate: 13621321521000,  // 有效期
+                remainingDay:2  // 当前时间距离优惠券过期的天数
+               
+            }
+        }
+        ...
+    ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#焦点图 $focusImage] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#推荐位 $adPosition] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift] 
+
+----------
+
+=== 1.13 搜索接口（M） === 
+**（mrobot已完成，请连开发机进行测试）** [[BR]]
+
+**需求：**[[BR]]
+1、topic实体新增一个字段 isOfficialPurchasing，用于区分爆料是否支持官方代购；[[BR]]
+
+**mrobot接口**：
+>http://mrobot.pconline.com.cn/s-300/best/search/listTopicSearch.xsp
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/02_search#搜索接口 搜索接口][[BR]]
+> http://best.pconline.com.cn/app/search/listTopicSearch.do
+
+**说明**
+
+> 分类搜索返回5个栏目筛选项 国内电商返回 优惠/发现；国外电商返回 海淘/发现 标签搜索返回5个栏目筛选项 关键词搜索返回关键词 + 5个栏目
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||searchType||1 按分类搜索 2 按电商搜索 3 按标签搜索 4 按关键词搜索||int||4||否||
+||searchCondition||根据searchType传入具体的内容，分类、电商、标签传入对应的id，关键词直接传入搜索的关键词字符串||根据searchType而定：1,对应int, 2(电商名称),3(标签名称),4（关键词）对应String||""||否||
+||sectionId||搜索栏目:0 优惠 1 海淘 2 发现 3 晒物 4 经验||int||不同类型的搜索出不同的默认值（依据app默认显示的栏目）||否||
+
+**返回**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: {
+    topics: [
+        {//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需求:新增字段】
+        },
+        ...
+    ],
+    searchSectionResults: [
+        {// from $sectionExtend
+            value: 1,
+            name: '海淘',
+            count: 12  
+        },
+        ...
+    ]
+  }
+}
+}}}
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic]
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#栏目搜索结果 $sectionExtend]
+
+----------
+
+
 == 2 地址管理 ==
 === 2.1添加收货地址 ===