聚超值2.0.0接口文档

1.首页列表数据接口

index

后端接口

 首页数据接口  焦点图

说明

获取推荐首页列表数据 + 焦点图（另外的接口，当pageNo为1时返回）

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是

返回

{
  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
    }
  ]
}

 $topic  $giftStock  $giftExchangeRule

---

2.优惠、海淘、发现、晒物、经验、海淘晒物、海淘经验、试用体验、专题列表数据接口

getTopicList

后端接口

 栏目爆料列表

说明

根据传入的栏目id，获取对应的爆料

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
sectionId	栏目id：0 优惠 1 海淘 2 发现 3 晒物 4 经验 5 海淘晒物 6 海淘经验 7 试用体验 8 专题	int	0	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  sectionId: 2,
  data: [
    "$topic"
  ]
}

 $topic

---

3.获取用户某个时间之后的爆料数和评论数

getNewCountForApp

后端接口

 获取用户某个时间之后的爆料数和评论数

说明

获取用户某个时间之后的爆料数,评论数和试用数

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id（HTTP Header的Cookie中）	-	String	""	是
lastAccessTime	最近一次访问该接口的时间	long(时间戳 秒)	当前时间	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    newTopicCount: 100,
    newCommentCount: 1,
    newSystemNoticeCount: 1
  }
}

---

4.单篇爆料、晒物、经验、体验报告、专题终端页（Web）

后端接口

 爆料详细信息

说明

单篇爆料或者晒物、经验、体验报告、专题终端页

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是
fontSize	字体大小	int	14	是
hd	是否显示高清图：0 否 1 是	int	0	否

返回

内嵌JSON数组的Web，包括点击交互链点

---

5.判断用户是否已收藏爆料

getTopicCollectCount

后端接口

 判断用户是否已收藏爆料

说明

判断用户是否已收藏爆料

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
topicId	爆料id	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  hasCollect: 0
}

---

收藏

collectForApp

后端接口

 收藏

说明

收藏

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
topicId	爆料id	int	0	是

返回

{
  status: 0,
  msg: "收藏成功"
}

---

取消收藏

decollectForApp

后端接口

 取消收藏

说明

取消收藏

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
topicId	爆料id	int	0	是

返回

{
  status: 0,
  msg: "取消收藏成功"
}

---

获取爆料赞和踩的数量

getTopicLikeAndDislikeCount

后端接口

 获取爆料赞和踩的数量

说明

用于终端页显示爆料的赞和踩的数量

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    goodCount: 12,
    badCount: 1,
    isVoted: 0
  }
}

---

赞或者踩

likeAndDislike

后端接口

 赞或者踩

说明

对爆料点赞或踩

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是
operate	操作：0 赞 1 踩	int	0	是

返回

{
  status: 0,
  msg: "感谢您的投票",
}

---

爆料正文中图片集列表

listTopicImages

后端接口

 获取爆料正文中的图片集

说明

从终端页中获取到所有上传的图片，用于浏览图模式

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  total: 100,
  data: [
    {
      index: 1,
      url: "http://img/pc.com.cn/1.png"
    }
  ]
}

---

代购商家列表

listpurchasing

后端接口

 获取爆料的代购列表

说明

获取代购列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是
pageNo	页数	int	1	否
pageSize	页面大小	int	10	否

返回

{
  status: 0,
  msg: "请求成功",
  total: 100,
  data: ["$purchasing"]
}

 $purchasing

---

求代购

addTopicBuyCount

后端接口

 求代购

说明

求代购

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
topicId	爆料id	int	0	是
price	求购价	int	0	否
name	称呼	String	""	是
contactWay	联系类型 1:手机号码 2：旺旺号码 3:QQ号码	int	0	是
contactInfo	联系方式	String	""	是

返回

{
  status: 0,
  msg: "申请成功"
}

---

优惠券终端页（Web）

getGiftInfo

后端接口

 优惠券信息

说明

优惠券终端页

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
giftId	礼品id	int	0	是
fontSize	字体大小	int	14	是

返回

内嵌JSON数组的Web，包括点击交互链点

---

广场数据接口

sunplaza

后端接口

 广场数据接口

说明

获取广场首页需要的内容

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    sunplazaEntrys: [
      "$sunplazaEntry"
    ],
    hotSpecial: "$setupSpecial",
    activitys: "$setupActivity",
    gift: "$setupGift",
    trial: "$trial",
    hotTopics: [
      "$topic"
    ]
  }
}

---

专题列表

getSpecialList

后端接口

 专题列表

说明

分页获取专题列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$special"
  ]
}

---

活动列表

listActivity

后端接口

 活动列表

说明

分页获取活动列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	否
pageSize	页面大小	int	10	否
isMall	1表示获取电商活动	int	0	否
isHaiTao	1表示获取海淘列表	int	0	否

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$activity"
  ]
}

 $activity

---

礼品列表

listGift

后端接口

 礼品列表

说明

分页获取礼品列表，传入type为礼品的类型进行查找

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
type	礼品类型： 1 礼品卡 2 实物礼品 3 优惠券	int	1	否
mallId	电商id，0表示查找所有	int	0	否

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$gift"
  ]
}

 $gift

---

获取电商列表，包含该电商的优惠券数量

listMallWithCouponCount

后端接口

 获取电商列表包含该电商的优惠券数量

说明

获取电商列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    totalCount: 100,
    mallCouponCount: [
      "$mallCouponCount"
    ]
  }
}

 $mallCouponCount

---

获取试用列表

listActivityList

后端接口

 获取试用列表

说明

根据分类获取试用列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
activityTypeId	试用类型id，0表示全部	int	0	是

返回

{
  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

后端接口

 获取试用类型列表

说明

获取试用类型列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须

返回

{
  status: 0,
  msg: "请求成功",
  data: [
    {
      activityTypeId: "类别ID",
      parentId: "父类别ID",
      name: "类别名称"
    }
  ]
}

---

试用详情终端页（Web）

后端接口

 试用详情

说明

试用详情终端页

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
activityId	试用id	int	0	是
fontSize	字体大小	int	14	是

返回

内嵌JSON数组的Web，包括点击交互链点

---

判断用户是否已申请

hasApplyForActivity

后端接口

 判断用户是否已申请

说明

判断用户是否已经申请

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
activityId	试用id	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    hasApply: 1
  }
}

---

申请试用

createApply

后端接口

 申请试用

说明

申请试用，需填写姓名（最多输入待定个字符）、手机号码（需为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	是

返回

{
  status: 0,
  msg: "申请成功",
}

---

搜索热词

listHotSearchTerms

后端接口

 搜索热词

说明

该推荐词又编辑在聚超值后台设置

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须

返回

{
  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

后端接口

 获取爆料分类

说明

获取爆料分类 使用场景：根据分类等级或父分类id查找所属的分类，一般用于首页或页面头部

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
level	1 一级分类 2 二级分类	int	0	否
parentId	上级分类id	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  total: 20,
  data: [
    {
      typeId: 1,
      name: "数码家电",
      level: 1
    }
  ]
}

---

搜索接口

listTopicSearch

后端接口

 搜索接口

说明

分类搜索返回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默认显示的栏目）	否

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: {
    topics: "$topic",
    searchSectionResults: [
      "$sectionExtend"
    ]
  }
}

---

获取电商列表

listMall

后端接口

 获取电商列表

说明

获取电商列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: ["$mall"]
}

 $mall

---

搜索推荐

searchKeywordHint

后端接口

 搜索推荐

说明

根据搜索输入推荐的热门搜索词

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
input	输入内容	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  data: [
    {
      count: "556",
      key: "iphone 5s"
    }
  ]
}

---

获取用户资料

getUserInfo

后端接口

 获取用户资料

说明

获取用户资料

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  data: [
    {
      "$user"
    }
  ]
}

 $user

---

获取用户扩展信息

getUserExtend

后端接口

 获取用户扩展信息  获取试用总数

说明

获取用户扩展信息

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  data: [
    {
      "$userExtend",
      trialCount: 2
    }
  ]
}

 $userExtend

---

判断是否有新的爆料或者试用

后端接口

 获取用户某个时间之后的爆料数和评论数  获取新通过的试用数

说明

判断是否有新的爆料或者试用

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
lastAccessTime	最近一次访问该接口的时间	时间戳 秒	当前时间	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  data: {
    newTopicCount: 100,
    newCommentCount: 1,
    newSystemNoticeCount: 1,
    newTrialCount: 2
  }
}

 $user

---

获取我的爆料

listMyTopic

后端接口

 获取我的爆料

说明

用于网友个人中心获取网友的爆料列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
status	爆料审核状态：1 审核通过 2 审核未通过或者待审	int	1	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$topic"
  ]
}

 $topic

---

获取收藏列表

listCollects

后端接口

 获取收藏列表

说明

用于网友个人中心获取收藏列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
index	0 优惠 1 海淘 2 发现 3 晒物 4 经验	int	0	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$collect"
  ]
}

 $collect

---

我的试用

listMyApply

后端接口

 获取收藏列表

说明

用于网友个人中心获取到已通过，申请中，未通过3中类型的使用申请

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
status	0 申请中 -1未通过 1通过	int	2	是

返回

{
  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封面"
    }
  ]
}

 $collect

---

我的优惠券列表

listMyGiftExchange

后端接口

 我的优惠券列表

说明

用于网友个人中心获取我的礼品列表，type=3的时候表示优惠券，包括未失效和已失效的

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
status	状态：0 已过期，1 未过期	int	0	是
type	1 礼品卡 2 实物礼品 3 优惠券	int	3	是

返回

{
  status: 0,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    "$giftCoupon"
  ]
}

 $giftCoupon

---

检查签到状态

checkSignInStatus

后端接口

 检查签到状态

说明

检查签到状态

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    signInStatus: 1,
    days: 12
  }
}

---

签到

signInfForApp

后端接口

 签到

说明

app端签到

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    signInStatus: 1,
    addInt: 10,
    addCoin: 12,
    point: 10,
    gold: 10,
    addPurchasingGold: 10,
    days: 1
  }
}

---

添加爆料

addTopic

后端接口

 添加爆料

说明

用于网友个人中心增加爆料功能

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
email	电子邮件	String	""	如果common_session_id为空，则必须输入email
fromUrl	来源	String	""	是
content	用户推荐理由	String	""	是

返回

{
  status: 0,
  msg: "请求成功"
}

---

设置分类订阅

add_subscription

后端接口

 设置分类订阅

说明

设置分类订阅

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
addition	加密后的token	String	""	是
ids	推送分类id	String	""	如果common_session_id为空，则必须输入email
open	是否开启推送： 0 不发送 1 发送	int	1	否
device	设备类型 0 ios 1 android	int	0	是

返回

{
  status: 0,
  msg: "设置成功"
}

---

添加精准订阅

add_subscription_second

后端接口

 添加精准订阅

说明

设置分类订阅

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
addition	加密后的token	String	""	是
keyword	关键词	String	""	是
open	是否开启推送： 0 不发送 1 发送	int	1	否
device	设备类型 0 ios 1 android	int	0	是

返回

{
  status: 0,
  msg: "订阅成功"
}

---

获取用户各个频道的收藏数量

countCollects

后端接口

 获取用户各个频道的收藏数量

说明

获取收藏列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "订阅成功",
  data: ["$sectionExtend"]
}

 $sectionExtend

---

获得系统和评论通知数量

getSysNoticeAndCommentNum

后端接口

 获得系统和评论通知数量

说明

获得系统通知数量和评论数量

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是

返回

{
  status: 0,
  msg: "请求成功",
  data: {
    sentCount: 1,
    receiveCount: 2,
    sysMsgCount: 3
  }
}

---

获得系统通知

listSystemNotice

后端接口

 获得系统通知

说明

获得系统通知

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是

返回

*注意：该接口返回格式为bip的接口格式，与其他接口不一致。*

{
  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

后端接口

 我收到的评论

说明

获得系统通知

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是

返回

*注意：该接口返回格式为bip的接口格式，与其他接口不一致。*

{
  pageNo: 1,
  pageSize: 10,
  total: 20,
  pageTotal: 2,
  msg: "请求成功",
  data: [
    "$receiveComment"
  ]
}

 $receiveComment

---