Changes between Initial Version and Version 1 of price_api

Timestamp:

03/06/2015 09:05:00 AM (11 years ago)

Author:

xuzhongzhou

Comment:

--

price_api

@@ +1 @@
+[[TOC]]
+
+= 聚超值2.0.0接口文档 = 
+
+== 首页列表数据接口 == 
+
+> index
+
+**后端接口**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/facade 首页数据接口] [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/11_focusImage 焦点图]
+
+**说明**
+
+> 获取推荐首页列表数据 + 焦点图（另外的接口，当pageNo为1时返回）
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  listIndex: [
+    {
+      type: 1,
+      value: "$topic"
+    },
+    {
+      type: 2,
+      value: {
+        adId: 51,
+        adTitle: "好东西哇",
+        price: "12块包邮",
+        imageUrl: "",
+        seq: 1,
+        positionIndex: 5,
+        topic: "$topic",
+        url: "http://g.pconline.com.cn/a/73727.html",
+        urlType: 1,
+        seq: 3
+      }
+    },
+    {
+      type: 3,
+      value: {
+        id: 1,
+        name: '铃木口琴',
+        num: 1,
+        applyNum: 12,
+        status: 1,
+        finalTime: '2014-10-10 10:11:10',
+        img_540_270: '',
+        price: 100,
+        score: 10,
+        gold: 10,
+        detail: ''
+      }
+    },
+    {
+      type: 4,
+      value: {
+        giftId: 1,
+        subGiftDesc: "好礼物",
+        giftStock: "$giftStock",
+        giftExchangeRule: "$giftExchangeRule",
+        name: "京东卡",
+        mallName: '京东',
+        type: 1,
+        imageUrl: "http://a.cn/1.png",
+        orderNum: 1,
+        giftPrice: 12.00,
+        createTime: 13251245124000,
+        disCount: "满400减20",
+        expiryDate: 13621321521000,
+        mallId: 12,
+        remainingDay: 2
+      }
+    }
+  ],
+  listFocus: [
+    {
+      focusImageId: 12,
+      typeId: 1,
+      imageUrl: "http://img.pconline.com.cn/7.jpg",
+      seq: 1,
+      positionIndex: 1,
+      focusTitle: "现货直接买!iPhone6 Plus 64G三网通5K1",
+      topicId: 125,
+      sectionType: 1,
+      url: "http://a.c.com/1.do",
+      createAt: 136521542140000
+    }
+  ]
+}
+}}}
+
+[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#礼品库存 $giftStock] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品兑换规则 $giftExchangeRule]
+
+----------
+
+== 优惠、海淘、发现、晒物、经验、海淘晒物、海淘经验、试用体验、专题列表数据接口 == 
+
+> getTopicList
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#栏目爆料列表 栏目爆料列表]
+
+**说明**
+
+> 根据传入的栏目id，获取对应的爆料
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||sectionId||栏目id：0 优惠 1 海淘 2 发现 3 晒物 4 经验 5 海淘晒物 6 海淘经验 7 试用体验 8 专题||int||0||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  sectionId: 2,
+  data: [
+    "$topic"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic]
+
+----------
+
+== 获取用户某个时间之后的爆料数和评论数 == 
+
+> getNewCountForApp
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获取用户某个时间之后的爆料数和评论数 获取用户某个时间之后的爆料数和评论数]
+
+**说明**
+
+> 获取用户某个时间之后的爆料数,评论数和试用数
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id（HTTP Header的Cookie中）||-||String||""||是||
+||lastAccessTime||最近一次访问该接口的时间||long(时间戳 秒)||当前时间||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    newTopicCount: 100,
+    newCommentCount: 1,
+    newSystemNoticeCount: 1
+  }
+}
+}}}
+
+----------
+
+== 单篇爆料、晒物、经验、体验报告、专题终端页（Web） == 
+
+> 
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#爆料详细信息 爆料详细信息]
+
+**说明**
+
+> 单篇爆料或者晒物、经验、体验报告、专题终端页
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+||fontSize||字体大小||int||14||是||
+||hd||是否显示高清图：0 否 1 是||int||0||否||
+
+**返回**
+
+{{{#!java
+内嵌JSON数组的Web，包括点击交互链点
+}}}
+
+----------
+
+== 判断用户是否已收藏爆料 == 
+
+> getTopicCollectCount
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#判断用是否已收藏爆料 判断用户是否已收藏爆料]
+
+**说明**
+
+> 判断用户是否已收藏爆料
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||topicId||爆料id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  hasCollect: 0
+}
+}}}
+
+----------
+
+== 收藏 == 
+
+> collectForApp
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#收藏1 收藏]
+
+**说明**
+
+> 收藏
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||topicId||爆料id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "收藏成功"
+}
+}}}
+
+----------
+
+== 取消收藏 == 
+
+> decollectForApp
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#取消收藏 取消收藏]
+
+**说明**
+
+> 取消收藏
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||topicId||爆料id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "取消收藏成功"
+}
+}}}
+
+----------
+
+== 获取爆料赞和踩的数量 == 
+
+> getTopicLikeAndDislikeCount
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#获取爆料赞和踩的数量 获取爆料赞和踩的数量]
+
+**说明**
+
+> 用于终端页显示爆料的赞和踩的数量
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    goodCount: 12,
+    badCount: 1,
+    isVoted: 0
+  }
+}
+}}}
+
+----------
+
+== 赞或者踩 == 
+
+> likeAndDislike
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#赞或者踩 赞或者踩]
+
+**说明**
+
+> 对爆料点赞或踩
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+||operate||操作：0 赞 1 踩||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "感谢您的投票",
+}
+}}}
+
+----------
+
+== 爆料正文中图片集列表 == 
+
+> listTopicImages
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#获取爆料正文中的图片集 获取爆料正文中的图片集]
+
+**说明**
+
+> 从终端页中获取到所有上传的图片，用于浏览图模式
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  total: 100,
+  data: [
+    {
+      index: 1,
+      url: "http://img/pc.com.cn/1.png"
+    }
+  ]
+}
+}}}
+
+----------
+
+== 代购商家列表 == 
+
+> listpurchasing
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/12_purchasing#获取爆料的代购列表 获取爆料的代购列表]
+
+**说明**
+
+> 获取代购列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+||pageNo||页数||int||1||否||
+||pageSize||页面大小||int||10||否||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  total: 100,
+  data: ["$purchasing"]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#代购商家 $purchasing]
+
+----------
+
+== 求代购 == 
+
+> addTopicBuyCount
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/12_purchasing#求代购 求代购]
+
+**说明**
+
+> 求代购
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||topicId||爆料id||int||0||是||
+||price||求购价||int||0||否||
+||name||称呼||String||""||是||
+||contactWay||联系类型 1:手机号码 2：旺旺号码 3:QQ号码||int||0||是||
+||contactInfo||联系方式||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "申请成功"
+}
+}}}
+
+----------
+
+== 优惠券终端页（Web） == 
+
+> getGiftInfo
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/05_gift#优惠券信息 优惠券信息]
+
+**说明**
+
+> 优惠券终端页
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||giftId||礼品id||int||0||是||
+||fontSize||字体大小||int||14||是||
+
+**返回**
+
+{{{#!java
+内嵌JSON数组的Web，包括点击交互链点
+}}}
+
+----------
+
+== 广场数据接口 == 
+
+> sunplaza
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/facade#广场数据接口 广场数据接口]
+
+**说明**
+
+> 获取广场首页需要的内容
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    sunplazaEntrys: [
+      "$sunplazaEntry"
+    ],
+    hotSpecial: "$setupSpecial",
+    activitys: "$setupActivity",
+    gift: "$setupGift",
+    trial: "$trial",
+    hotTopics: [
+      "$topic"
+    ]
+  }
+}
+}}}
+
+----------
+
+== 专题列表 == 
+
+> getSpecialList
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/06_special#专题列表 专题列表]
+
+**说明**
+
+> 分页获取专题列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$special"
+  ]
+}
+}}}
+
+----------
+
+== 活动列表 == 
+
+> listActivity
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/08_activity#活动列表 活动列表]
+
+**说明**
+
+> 分页获取活动列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||否||
+||pageSize||页面大小||int||10||否||
+||isMall||1表示获取电商活动||int||0||否||
+||isHaiTao||1表示获取海淘列表||int||0||否||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$activity"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#活动 $activity]
+
+----------
+
+== 礼品列表 == 
+
+> listGift
+
+**后端接口**
+
+> [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||否||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$gift"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift]
+
+----------
+
+== 获取电商列表，包含该电商的优惠券数量 == 
+
+> listMallWithCouponCount
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/07_mall#获取电商列表包含该电商的优惠券数量 获取电商列表包含该电商的优惠券数量]
+
+**说明**
+
+> 获取电商列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    totalCount: 100,
+    mallCouponCount: [
+      "$mallCouponCount"
+    ]
+  }
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#电商优惠券数量vo $mallCouponCount]
+
+----------
+
+== 获取试用列表 == 
+
+> listActivityList
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#获取试用列表 获取试用列表]
+
+**说明**
+
+> 根据分类获取试用列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||activityTypeId||试用类型id，0表示全部||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  trialType: 2,
+  data: [
+    {
+      activityId: "试用活动id",
+      title: "试用活动标题",
+      applyEndAt: "申请结束时间",
+      type: "活动类型 0海测 1精测",
+      quantity: "产品数量",
+      applyCount: "提交申请的人数",
+      face_1: "390x195封面",
+      face_2: "540x270封面",
+      face_3: "130x130封面",
+      face_4: "140x170封面"
+    }
+  ]
+}
+}}}
+
+----------
+
+== 获取试用类型列表 == 
+
+> listActivityTypeList
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#获取试用类型列表 获取试用类型列表]
+
+**说明**
+
+> 获取试用类型列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: [
+    {
+      activityTypeId: "类别ID",
+      parentId: "父类别ID",
+      name: "类别名称"
+    }
+  ]
+}
+}}}
+
+----------
+
+== 试用详情终端页（Web） == 
+
+> 
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#试用详情 试用详情]
+
+**说明**
+
+> 试用详情终端页
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||activityId||试用id||int||0||是||
+||fontSize||字体大小||int||14||是||
+
+**返回**
+
+{{{#!java
+内嵌JSON数组的Web，包括点击交互链点
+}}}
+
+----------
+
+== 判断用户是否已申请 == 
+
+> hasApplyForActivity
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#判断用户是否已申请 判断用户是否已申请]
+
+**说明**
+
+> 判断用户是否已经申请
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||activityId||试用id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    hasApply: 1
+  }
+}
+}}}
+
+----------
+
+== 申请试用 == 
+
+> createApply
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#申请试用 申请试用]
+
+**说明**
+
+> 申请试用，需填写姓名（最多输入待定个字符）、手机号码（需为1开头的11位数字）、寄送地址（最多输入待定个字符）、QQ号码（需为5~11位数字）、申请理由（至少输入20个汉字）。申请按钮固定在屏幕底部，不随页面滚动。点击”提交申请“，若各输入项均符合规则，则提示申请已受理并返回试用详情页。点击”提交申请“，若某个输入项不符合规则，则页面显示相应提示。
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||activityId||试用id||long||0||是||
+||name||姓名||String||""||是||
+||telNum||寄送地址||String||""||是||
+||address||试用id||long||0||是||
+||qq||qq号码||int||0||是||
+||reason||申请理由||String||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "申请成功",
+}
+}}}
+
+----------
+
+== 搜索热词 == 
+
+> listHotSearchTerms
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/02_search#搜索热词 搜索热词]
+
+**说明**
+
+> 该推荐词又编辑在聚超值后台设置
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: [
+    {
+      encodeKey: "%E8%85%95%E8%A1%A8",
+      key: "腕表"
+    },
+    {
+      encodeKey: "%E6%88%B7%E5%A4%96",
+      key: "户外"
+    },
+    {
+      encodeKey: "%E4%B9%90%E9%AB%98",
+      key: "乐高"
+    },
+    {
+      encodeKey: "%E6%B4%97%E6%8A%A4%E7%94%A8%E5%93%81",
+      key: "洗护用品"
+    },
+    {
+      encodeKey: "%E8%B6%85%E6%9E%81%E6%9C%AC",
+      key: "超极本"
+    },
+    {
+      encodeKey: "%E6%89%8B%E6%9C%BA",
+      key: "手机"
+    }
+  ]
+}
+}}}
+
+----------
+
+== 爆料分类 == 
+
+> listTopicType
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_1_topicType#获取爆料分类 获取爆料分类]
+
+**说明**
+
+> 获取爆料分类
+> 使用场景：根据分类等级或父分类id查找所属的分类，一般用于首页或页面头部
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||level||1 一级分类 2 二级分类||int||0||否||
+||parentId||上级分类id||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  total: 20,
+  data: [
+    {
+      typeId: 1,
+      name: "数码家电",
+      level: 1
+    }
+  ]
+}
+}}}
+
+----------
+
+== 搜索接口 == 
+
+> listTopicSearch
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/02_search#搜索接口 搜索接口]
+
+**说明**
+
+> 分类搜索返回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: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: {
+    topics: "$topic",
+    searchSectionResults: [
+      "$sectionExtend"
+    ]
+  }
+}
+}}}
+
+----------
+
+== 获取电商列表 == 
+
+> listMall
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/07_mall#获取电商列表 获取电商列表]
+
+**说明**
+
+> 获取电商列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: ["$mall"]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#电商 $mall]
+
+----------
+
+== 搜索推荐 == 
+
+> searchKeywordHint
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/02_search#搜索推荐 搜索推荐]
+
+**说明**
+
+> 根据搜索输入推荐的热门搜索词
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||input||输入内容||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  data: [
+    {
+      count: "556",
+      key: "iphone 5s"
+    }
+  ]
+}
+}}}
+
+----------
+
+== 获取用户资料 == 
+
+> getUserInfo
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获取用户资料 获取用户资料]
+
+**说明**
+
+> 获取用户资料
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  data: [
+    {
+      "$user"
+    }
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#用户信息 $user]
+
+----------
+
+== 获取用户扩展信息 == 
+
+> getUserExtend
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获取用户扩展信息 获取用户扩展信息]
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#获取试用总数 获取试用总数]
+
+**说明**
+
+> 获取用户扩展信息
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  data: [
+    {
+      "$userExtend",
+      trialCount: 2
+    }
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#用户扩展信息 $userExtend]
+
+----------
+
+== 判断是否有新的爆料或者试用 == 
+
+> 
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获取用户某个时间之后的爆料数和评论数 获取用户某个时间之后的爆料数和评论数]
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/04_trial#获取新通过的试用数 获取新通过的试用数]
+
+**说明**
+
+> 判断是否有新的爆料或者试用
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||lastAccessTime||最近一次访问该接口的时间||时间戳 秒||当前时间||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  data: {
+    newTopicCount: 100,
+    newCommentCount: 1,
+    newSystemNoticeCount: 1,
+    newTrialCount: 2
+  }
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#用户信息 $user]
+
+----------
+
+== 获取我的爆料 == 
+
+> listMyTopic
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#获取我的爆料 获取我的爆料]
+
+**说明**
+
+> 用于网友个人中心获取网友的爆料列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||status||爆料审核状态：1 审核通过 2 审核未通过或者待审||int||1||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$topic"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic]
+
+----------
+
+== 获取收藏列表 == 
+
+> listCollects
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#获取收藏列表 获取收藏列表]
+
+**说明**
+
+> 用于网友个人中心获取收藏列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||index||0 优惠 1 海淘 2 发现 3 晒物 4 经验||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$collect"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#收藏 $collect]
+
+----------
+
+== 我的试用 == 
+
+> listMyApply
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#获取收藏列表 获取收藏列表]
+
+**说明**
+
+> 用于网友个人中心获取到已通过，申请中，未通过3中类型的使用申请
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||status||0 申请中 -1未通过 1通过||int||2||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    {
+      applyId: "试用申请id",
+      activityId: "试用活动id",
+      title: "试用活动标题",
+      status: "试用申请状态",
+      createAt: "试用申请时间",
+      face_1: "390x195封面",
+      face_2: "540x270封面",
+      face_3: "130x130封面",
+      face_4: "140x170封面"
+    }
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#收藏 $collect]
+
+----------
+
+== 我的优惠券列表 == 
+
+> listMyGiftExchange
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/05_gift#我的优惠券列表 我的优惠券列表]
+
+**说明**
+
+> 用于网友个人中心获取我的礼品列表，type=3的时候表示优惠券，包括未失效和已失效的
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+||status||状态：0 已过期，1 未过期||int||0||是||
+||type||1 礼品卡 2 实物礼品 3 优惠券||int||3||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  pageNo: 1,
+  pageSize: 20,
+  total: 100,
+  data: [
+    "$giftCoupon"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#优惠券 $giftCoupon]
+
+----------
+
+== 检查签到状态 == 
+
+> checkSignInStatus
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#检查签到状态 检查签到状态]
+
+**说明**
+
+> 检查签到状态
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    signInStatus: 1,
+    days: 12
+  }
+}
+}}}
+
+----------
+
+== 签到 == 
+
+> signInfForApp
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#签到 签到]
+
+**说明**
+
+> app端签到
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    signInStatus: 1,
+    addInt: 10,
+    addCoin: 12,
+    point: 10,
+    gold: 10,
+    addPurchasingGold: 10,
+    days: 1
+  }
+}
+}}}
+
+----------
+
+== 添加爆料 == 
+
+> addTopic
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#添加爆料 添加爆料]
+
+**说明**
+
+> 用于网友个人中心增加爆料功能
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||email||电子邮件||String||""||如果common_session_id为空，则必须输入email||
+||fromUrl||来源||String||""||是||
+||content||用户推荐理由||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功"
+}
+}}}
+
+----------
+
+== 设置分类订阅 == 
+
+> add_subscription
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/14_subscription#设置分类订阅 设置分类订阅]
+
+**说明**
+
+> 设置分类订阅
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||addition||加密后的token||String||""||是||
+||ids||推送分类id||String||""||如果common_session_id为空，则必须输入email||
+||open||是否开启推送： 0 不发送 1 发送||int||1||否||
+||device||设备类型 0 ios 1 android||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "设置成功"
+}
+}}}
+
+----------
+
+== 添加精准订阅 == 
+
+> add_subscription_second
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/14_subscription#添加精准订阅 添加精准订阅]
+
+**说明**
+
+> 设置分类订阅
+
+**提交方式**
+
+> POST
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||addition||加密后的token||String||""||是||
+||keyword||关键词||String||""||是||
+||open||是否开启推送： 0 不发送 1 发送||int||1||否||
+||device||设备类型 0 ios 1 android||int||0||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "订阅成功"
+}
+}}}
+
+----------
+
+== 获取用户各个频道的收藏数量 == 
+
+> countCollects
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/13_collect#获取用户各个频道的收藏数量 获取用户各个频道的收藏数量]
+
+**说明**
+
+> 获取收藏列表
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "订阅成功",
+  data: ["$sectionExtend"]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#栏目搜索结果 $sectionExtend]
+
+----------
+
+== 获得系统和评论通知数量 == 
+
+> getSysNoticeAndCommentNum
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获得系统和评论通知数量 获得系统和评论通知数量]
+
+**说明**
+
+> 获得系统通知数量和评论数量
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+
+**返回**
+
+{{{#!java
+{
+  status: 0,
+  msg: "请求成功",
+  data: {
+    sentCount: 1,
+    receiveCount: 2,
+    sysMsgCount: 3
+  }
+}
+}}}
+
+----------
+
+== 获得系统通知 == 
+
+> listSystemNotice
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#获得系统通知 获得系统通知]
+
+**说明**
+
+> 获得系统通知
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+
+**返回**
+
+*注意：该接口返回格式为bip的接口格式，与其他接口不一致。*
+
+{{{#!java
+{
+  pageCount: 15,
+  pageNo: 1,
+  pageSize: 10,
+  total: 2,
+  resultList: [
+    {
+      accountId: 28467067,
+      content: "对您的爆料《罗技 UE4000 游戏耳机 试用报告》的反馈：部分图片可以使用800px宽，可能会稍微好点",
+      createTime: 1411615093000,
+      groupSend: 0,
+      groupType: 0,
+      id: 97207866,
+      resultText: "",
+      senderId: 0,
+      siteId: 1,
+      status: 1,
+      type: {
+        description: "今日最超值",
+        groupType: 0,
+        id: 1006,
+        name: "今日最超值",
+        siteId: 1,
+        templateId: 1006
+      },
+      typeId: 1006
+    }
+  ]
+}
+}}}
+
+----------
+
+== 我收到的评论 == 
+
+> listMyReceiveComment
+
+**后端接口**
+
+> [http://trac.pc.com.cn/pc_best/wiki/app2.0/03_personal#我收到的评论 我收到的评论]
+
+**说明**
+
+> 获得系统通知
+
+**提交方式**
+
+> GET
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||common_session_id||-||String||""||是||
+||pageNo||页数||int||1||是||
+||pageSize||页面大小||int||10||是||
+
+**返回**
+
+*注意：该接口返回格式为bip的接口格式，与其他接口不一致。*
+
+{{{#!java
+{
+  pageNo: 1,
+  pageSize: 10,
+  total: 20,
+  pageTotal: 2,
+  msg: "请求成功",
+  data: [
+    "$receiveComment"
+  ]
+}
+}}}
+
+[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#收到的评论 $receiveComment]
+
+----------