[[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]

----------