wiki:price_api

Context Navigation

Version 122 (modified by chenziyang, 11 years ago) (diff)
--

聚超值2.0.0接口文档

一.基本约定

  1.开发机、测试机代理地址：
  mrobot开发机代理：192.168.10.199  端口：1080
  mrobot测试机代理：192.168.10.198  端口：1080
  
  2.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。
  
  3.当接口处理异常时，HTTP STATUS CODE 返回非200，并且给出具体的错误信息。
      {
         "desc":"给用户的提示放在这里"
      }
      
  4.接口默认的字符编码是UTF-8，接口需要实现对req-enc和resp-enc参数的支持。
  
  5.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。
  
  6.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号
  
  7.需要分页的接口，统一返回以下字段:  pageNo,pageSize,total

  8.接口标题后小括号的字母代表开发的优先级，h——高，m——中，l——低

二.接口列表

电脑网应用端测试环境域名 v42.pconline.com.cn

电脑网应用端线上环境域名 best.pconline.com.cn

1 首页模块

1.1 （h）首页列表数据接口

mrobot接口： (接口已完成，请连开发机进行测试)

http://mrobot.pconline.com.cn/s-900/best/cms/listHomepage.xsp
eg: http://mrobot.pconline.com.cn/s-900/best/cms/listHomepage.xsp?pageNo=1&pageSize=10

后端接口

首页数据接口焦点图

说明

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

提交方式

GET

参数

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

{
    status: 1, 
    msg: "请求成功",
    pageNo: 1,
    pageSize: 20,
    pageTotal: 2168,
    total: 43357,
    focus: [//焦点图
        {//from $focusImage
            focusImageId: 12,
            typeId: 爆料类型Id
            topicId: 125,  // 爆料id
            section: 1, // 栏目：0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题
            topSection: 1  // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验
            imageUrl: "http://img.pconline.com.cn/7.jpg",  // 焦点图
            focusTitle: "哪家最低？MacBook/Watch美港日扫货攻略",
            seq: 1,
        }
        ...
    ]
    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  // 是否白菜价合集
            }
        }
        {
            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
                couponId: 123,  // 优惠券Id
                giftId: 1,  // 礼品Id
                giftName: "京东卡",
                needScore: 10, //所需积分
                needGold: 2,//所需金币
                mallId:  12,  // 电商Id
                mallName: '京东',  // 电商名称
                imageUrl: "http://a.cn/1.png",  // 图片
                disCount: "满400减20",  // 优惠券额度
                createTime: 13251245124000,  // 创建时间
                expiryDate: 13621321521000,  // 有效期
                remainingDay:2  // 当前时间距离优惠券过期的天数
                expiry: 1  // 是否有效  true 有效  false 过期
            }
        }
        ...
    ]
}

$focusImage $topic $adPosition $gift

1.2 （h）优惠、海淘、发现、晒物、经验、试用体验、专题列表数据接口

mrobot接口：（mrobot补充） (开发已完成，请连开发机进行测试)

http://mrobot.pconline.com.cn/s-900/best/cms/getTopicList.xsp[[BR]]

eg:http://mrobot.pconline.com.cn/s-900/best/cms/getTopicList.xsp?sectionId=0&pageNo=2&pageSize=20

接口名：

listTopics

后端接口

栏目爆料列表

说明

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

提交方式

GET

参数

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

{
    status: 1, 
    msg: "请求成功",
    pageNo: 1,
    pageSize: 20,
    pageTotal: 2168,
    total: 43357
    data:[
        {//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",  // 创建者名称，邮箱前缀
        }
        ...
    ]
}

$topic

1.3 （h）获取用户最新动态变化

获取新的爆料数评论数系统消息数和试用数

说明

获取用户某个时间之后的新动态变化

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

mrobot接口：（mrobot补充）

接口名：

topicDetail

后端接口

爆料详细信息

说明

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

提交方式

GET

参数

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

返回
web页面的html代码，内嵌JSON格式的附加信息，以及点击交互的跳转协议
附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾

附加信息：

爆料类型	附加信息
优惠、海淘、发现	#data1#
晒物、经验	#data2#

#data1#包含：
{
  topicId: 13253,//爆料id
  topicType: 1,//0优惠，1海淘，2 发现
  bestBuyLink:"bestbuy://topic-1.cc"  //直达链接，可能是自定义的协议或者普通的url
}

#data1#包含：
{
  topicId: 13253, //爆料id
  topicType: 3//3 晒物，4经验
}

跳转协议：
优惠/海淘/发现详情终端页:

协议	参数说明	触发事件
pconlinebestbuy://bestbuy-giftCoupon-detail?giftId={giftId}	giftId：礼品id	点击爆料详情终端页的"优惠券"内时触发，进入优惠券详情
pconlinebestbuy://bestbuy-show-photo?topicId={topicId}&currentIndex={currentIndex}	topicId：爆料id；currentIndex：图片序号	点击爆料详情终端页的任一张图片时触发，浏览大图
pconlinebestbuy://bestbuy-purchasing-list?topicId={topicId}	topicId：爆料id	点击爆料详情终端页的"有家商家可代购"时触发，进入商家列表
pconlinebestbuy://bestbuy-purchasing-dg-terminal?link={link}	link：代购地址	点击爆料详情终端页底部的"推荐代购商家"时触发，进入商家淘宝商品页

晒物详情终端页:

协议	参数说明	触发事件
pconlinebestbuy://bestbuy-show-photo?topicId={topicId}&currentIndex={currentIndex}	topicId：爆料id；currentIndex：图片序号	点击爆料详情终端页的任一张图片时触发，浏览大图
pconlinebestbuy://bestbuy-commodity-buy?link={link}	link：商品购买地址	跳转进入商品购买页点击爆料详情终端页中的"商品链接"时触发

经验详情终端页:

协议	参数说明	触发事件
pconlinebestbuy://bestbuy-show-photo?topicId={topicId}&currentIndex={currentIndex}	topicId：爆料id；currentIndex：图片序号	点击爆料详情终端页的任一张图片时触发，浏览大图

1.5 （m）判断用户是否已收藏爆料

mrobot接口：（mrobot补充） (接口已完成，请连开发机进行测试)

http://mrobot.pconline.com.cn/s-0/best/bbs/checkTopicCollectStatus.xsp
eg:http://mrobot.pconline.com.cn/s-0/best/bbs/checkTopicCollectStatus.xsp?topicId=17960

接口名：

checkTopicCollectStatus

后端接口

判断用户是否已收藏爆料

说明

判断用户是否已收藏爆料

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  hasCollect: 0// 0 表示未收藏   1 表示已收藏
}

1.6 （m）收藏

mrobot接口：（mrobot补充）

接口名：

collectOneTopic

后端接口

收藏

说明

收藏

提交方式

POST

参数

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

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

1.7 （m）取消收藏

mrobot接口：（mrobot补充）

接口名：

decollectOneTopic

后端接口

取消收藏

说明

取消收藏

提交方式

POST

参数

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

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

1.8 （m）获取爆料赞和踩的数量

mrobot接口：（mrobot补充） (mrobot已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pconline.com.cn/s-2/best/bbs/getTopicLikeAndDislikeCount.xsp[[BR]]

eg:http://mrobot.pconline.com.cn/s-2/best/bbs/getTopicLikeAndDislikeCount.xsp?topicId=17960

接口名：

getTopicLikeAndDislikeCount

后端接口

获取爆料赞和踩的数量

说明

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

提交方式

GET

参数

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

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

1.9 （m）赞或者踩

mrobot接口：（mrobot补充）

接口名：

likeAndDislike

后端接口

赞或者踩

说明

对爆料点赞或踩

提交方式

POST

参数

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

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

1.10 （l）爆料正文中图片集列表

mrobot接口：（mrobot补充）

接口名：

listTopicImages

后端接口

获取爆料正文中的图片集

说明

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

提交方式

GET

参数

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

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

1.11 （l）代购商家列表

mrobot接口：（mrobot补充）

接口名：

listPurchasing

后端接口

获取爆料的代购列表

说明

获取代购列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  pageTotal: 5,
  total: 100,
  data: {//from $purchasing
      description: "超值代购",  //代购商家描述
      hasSpotGoods: 1,  // 是否有现货：0 现货/1 代购
      link: "http://www.taobao.com/item_1.html"  //代购地址  
      userName: "Jason",  //用户名，对应后端参数"name"
      nickName: "Jason",  //昵称
      logo: "http://img.pc.com.cn/1.png",  //头像 从平台获取
      price: 128,  //价格 
  }
}

$purchasing $user

1.12 （l）获取求购数（20150326）

mrobot接口： http://mrobot.pconline.com.cn/s/best/purchasing/getTopicBuyCount.xsp

接口名：

getTopicBuyCount

后端接口

获得爆料求购数

http://best.pconline.com.cn/app/purchasing/getTopicBuyCount.do

说明

获得爆料求购数

提交方式

GET

参数

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

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

1.13 （l）求代购规则（20150326）

mrobot接口：（mrobot补充）

接口名：

getTopicBuyRule

后端接口

求代购规则

说明

求代购规则

提交方式

GET

参数无

{
  status: 1,
  msg: "请求成功",
  data: {
    awardId: 17,  规则id
        description: "发布求购扣除钻石",  // 规则描述
        experience: 0,  // 所需经验
        gold: 0,  // 所需金币
        pristige: 0,  // 所需威望
        purchasingGold: 0,  // 所需钻石
        score: 0,  // 所需积分
        totalCount: 0  // 每天限制次数
  }
}

1.14 （l）求代购

mrobot接口：（mrobot补充）

接口名：

addTopicBuyCount

后端接口

求代购

说明

求代购

提交方式

POST

参数

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

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

1.15 （l）优惠券终端页（Web）

mrobot接口：（mrobot补充）

接口名：

giftDetail

后端接口

优惠券信息

说明

优惠券终端页

提交方式

GET

参数

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

  web页面的html代码，内嵌JSON格式的附加信息，以及点击交互的跳转协议
  附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾

  >>>>>>>>>>附加信息:
  {
      （暂无）
  }
  <<<<<<<<<<



  >>>>>>>>>>跳转协议：

  ---领取优惠券 点击优惠券详情底部的“领取优惠券”按钮时触发
  pconlinebestbuy://bestbuy-get-giftCoupon?giftId={giftId}&giftName={giftName}&needScore={needScore}&needGold={needGold}
  跳转参数说明：
  giftId：礼品id
  giftName：优惠券标题
  needScore：兑换所需积分
  needGold：兑换多需金币

  <<<<<<<<<<

1.14 （l）领取优惠券

mrobot接口：（mrobot补充）

接口名：

exchangeCoupon

后端接口

领取优惠券接口

说明

兑换优惠券接口，是否登录，是否已领完，是否已失效，金币，积分是否不足

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
giftId	礼品Id，注意这里传入礼品的giftId而不是优惠券的couponId	int	1	是

{
    status: 1,
    msg: "兑换成功",
    data: {
        status:1,  // 1 兑换成功  -1  请刷新页面重试  -2 该优惠券无效   -3 该优惠券已过期  -4 兑换出错，请稍后再试。 -5 优惠券领取次数超过限制!  -6 金币或积分不足!  -7 该优惠券无效或已全部被兑换!  -8 兑换失败！
        cardNum: 123, //券号
        giftStatus: 1,
        cardPassword: 123456, //密码
        mallUrl: "http://a.b.c", //优惠券所属的电商首页
        gold:1, //用户的金币数
        score: 2 //用户的积分数
    }
}

2 发现模块

2.1 发现列表

http://trac.pc.com.cn/iphone/wiki/price_api#a1.2h优惠海淘发现晒物经验试用体验专题列表数据接口

2.2 发现详情

http://trac.pc.com.cn/iphone/wiki/price_api#a1.4m单篇爆料晒物经验体验报告专题终端页Web

3 广场模块

3.1 （h）广场数据接口

mrobot接口：（mrobot补充） (开发已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pconline.com.cn/s-900/best/cms/sunplaza.xsp

eg:http://mrobot.pconline.com.cn/s-900/best/cms/sunplaza.xsp

接口名：

sunplaza

后端接口

广场数据接口

说明

获取广场首页需要的内容. 其中最新试用是上面这个

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  data:{
     sunplazaEntrys: [//四个自由快捷入口
         {//from $sunplazaEntry
            type: 1,  // 1 标签爆料列表，2 分类爆料列表，3 电商爆料列表，4 爆料终端页，5 专题页，6 试用详情页，7 外链，8 搜索结果页，9商家优惠券列表
            tagId: 123, // 标签爆料id int。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {
            type: 2,  // 2 分类爆料列表
            catId: 123, // 分类爆料id int。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {//from $sunplazaEntry
            type: 3,  // 3 电商爆料列表
            mallId: 13, // 电商爆料id int。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {//from $sunplazaEntry
            type: 4,  // 4 爆料终端页
            topicId: 123, // 爆料id int。字段名由mrobot接口根据type类型定义
            topSection: 1  // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {//from $sunplazaEntry
            type: 5,  // 5 专题页
            url: "http://www.a.cc/w.do", // 专题页链点。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {//from $sunplazaEntry
            type: 7,  // 7 外链
            url: "http://www.a.cc/w.do", // 外链链点。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        {//from $sunplazaEntry
            type: 8,  // 8 搜索结果页
            keyword: "苹果", // 搜索热词。字段名由mrobot接口根据type类型定义
            icon: "http://img.pconline.com.cn/1.png",
            name: "白菜价"
        },
        ...
     ],
     hotSpecial: {//热门专题一个 from $special
        specialId：1，
        title: "双十一精选",
        cover: "http://img.pconline.com.cn/1.png",
        url: "http://g.pconline.com.cn/link/a.html"
     }, 
     activitys: [//热门电商活动四个
        {//from $activity
            activityId: 1,
            appCover: "http://1.c.cn/2.png",  // app活动封面
            title: "亚马逊精选礼品图书满300-100",
            url: "http://www.a.cc/w.do",  // 链点
            urlType: 1   // 爆料终端页   2 外部网页链接
            topicId: 123,  // 爆料id
            sectionId: 1,  // 栏目id
            sectionType: 1,  // 爆料类型
            topicTitle: "好东西",  // 爆料标题
            description: "好活动",  // 活动描述
            seq: 1,  // 排序
            isTop:  1,  // 是否置顶
            isHaiTao: 1,  // 是否海淘活动
            isMall: 1,  // 是否电商活动
            createAt: 13251245121000,
        },
        ...
     ],
     gift: { // 热门优惠券一个from $gift
        couponId: 123,  // 优惠券Id
        giftId: 1,  // 礼品Id
        giftName: "京东卡",
        needScore: 10, //所需积分
        needGold: 2,//所需金币
        mallId:  12,  // 电商Id
        mallName: '京东',  // 电商名称
        imageUrl: "http://a.cn/1.png",  // 图片
        disCount: "满400减20",  // 优惠券额度
        createTime: 13251245124000,  // 创建时间
        expiryDate: 13621321521000,  // 有效期
        remainingDay:2  // 当前时间距离优惠券过期的天数
        expiry: 1  // 是否有效  true 有效  false 过期
    }, 
//-------2015.3.27决定去掉V2.0.0【试用】相关的功能，故此处不需要返回trail字段
    trial:{ //最新试用一个 
         activityId:12,  // 试用活动id
         title:"",       // 试用活动标题
         applyEndAt:13251245124000,  // 申请结束时间
         type:0,         // 活动类型 0海测 1精测
         quantity:5,     // 产品数量
         applyCount:300, // 提交申请的人数
         face_1:"",      // 390x195封面
         face_2:"",      // 540x270封面
         face_3:"",      // 130x130封面
         face_4:""       // 140x170封面
     },
     hotTopics: [ //排行榜五个
         {//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  // 是否白菜价合集
         },
         ...
     ]
     }
  }
}

$appSunplazaEntry
$special
$gift
$activity
$topic

3.2 （h）获取新试用数（V2.0.0不需提供）

mrobot接口：（mrobot补充） (mrobot开发已完成，可连开发机进行测试)：

mrobot:http://mrobot.pconline.com.cn/s-2/best/bbs/countActivity.xsp[[BR]]

eg:http://mrobot.pconline.com.cn/s-2/best/bbs/countActivity.xsp?limit=2&date=1427678976999

接口名：

countActivity

后端接口

某个时间后的有效试用条数

说明

某个时间后的有效试用条数

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
limit	限制条数	int	1	否
date	时间	String	当前时间(毫秒数)	是

{
  status: 1,
  msg: "请求成功",
  limit： 1,
  data:   2     // 有效试用个数
}

3.3 （h）专题列表

mrobot接口：（mrobot补充） (开发已完成，请连开发机进行测试)

http://mrobot.pconline.com.cn/s-900/best/cms/getSpecialList.xsp
eg:http://mrobot.pconline.com.cn/s-900/best/cms/getSpecialList.xsp?pageNo=0&pageSize=10&recommendToAppSunplaza=-1

接口名：

listSpecials

后端接口

专题列表

说明

分页获取专题列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
     {//from $special
        specialId：1，
        title: "双十一精选",
        cover: "http://img.pconline.com.cn/1.png",
        url: "http://g.pconline.com.cn/link/a.html"
     },
     ...
  ]
}

$special

3.4 （h）商家活动列表

mrobot接口：（mrobot补充） (开发已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pconline.com.cn/s-900/best/cms/listActivity.xsp eg:http://mrobot.pconline.com.cn/s-900/best/cms/listActivity.xsp?pageNo=1&pageSize=10

接口名：

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: [
    {//from $activity    
        activityId: 1,
        cover: "http://1.c.cn/1.png",  // PC活动封面
        appCover: "http://1.c.cn/2.png",  // app活动封面。该字段后端暂时没设置，故移动客户端也使用cover字段
        title: "亚马逊精选礼品图书满300-100",
        url: "http://www.a.cc/w.do",  // 链点
        urlType: 1   // 爆料终端页   2 外部网页链接
        sectionId: 1,  // 栏目id
        sectionType: 1,  // 爆料类型
        topicId: 123,  // 爆料id
        seq: 1,  // 排序
        isTop:  1,  // 是否置顶，1 是  0  否
        createAt: 13251245121000
    },
    ...
  ]
}

$activity

3.5 （h）优惠券列表

mrobot接口： http://mrobot.pconline.com.cn/s/best/gift/listGift.xsp

接口名：

listGift

后端接口

礼品列表

http://best.pconline.com.cn/app/gift/cache/listGift.do

说明

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

提交方式

GET

参数

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

{
  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 过期
    },
    ...
  ]
}

$gift

3.6 （h）获取用户金币和积分

mrobot接口：（mrobot补充）

接口名：

getUserScoreAndGold

后端接口

获取用户资料

说明

获取用户金币和积分

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  data: {//from $user
          userId: 12,
          goldAmount:12,  // 金币
          score: 10,  // 积分
    }
}

$user

3.7 （h）优惠券种类筛选页

mrobot接口：（mrobot补充）

接口名：

listMallsWithCouponCount

后端接口

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

说明

获取电商列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  data: {
    totalCount: 100,
    mallCouponCount: [
        {// from $mallGiftCount
            mallId: 1, 
            mallName: "京东", //电商名称
            url: "http://www.jd.com", // 电商URL
            seq: 12,  // 排序
            typeId: 1,  // 国内外电商  0国内电商 1国外电商
            areaType: 1,  // 地域类型  0其他电商 1美淘电商 2日淘电商
            imageUrl: "http://img.pc.com.cn/1.png"
            count:20
        },
        ...
    ]
  }
}

$mallCouponCount

3.8 （h）获取试用列表（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

listActivityList

后端接口

获取试用列表

说明

根据分类获取试用列表

提交方式

GET

参数

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

{
  status: 1,
  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封面"
    }
  ]
}

3.9 （h）获取试用类型列表（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

listActivityTypeList

后端接口

获取试用类型列表

说明

获取试用类型列表

提交方式

GET

参数

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

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

3.10 （m）试用详情终端页（Web）（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

trialActivityDetail

后端接口

试用详情

说明

试用详情终端页

提交方式

GET

参数

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

  web页面的html代码，内嵌JSON格式的附加信息，以及点击交互的跳转协议
  附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾

  >>>>>>>>>>附加信息:
  {
    （暂无）
  }
  <<<<<<<<<<



  >>>>>>>>>>跳转协议：

  ---跳转进入试用申请页 点击试用详情终端页的"申请使用"按钮时触发
  pconlinebestbuy://bestbuy-trial-apply?activityId={activityId}
  跳转参数说明：
  activityId：试用id

  <<<<<<<<<<

3.11 （m）判断用户是否已申请（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

hasApplyForActivity

后端接口

判断用户是否已申请

说明

判断用户是否已经申请

提交方式

GET

参数

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

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

3.12 （l）申请试用（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

createApply

后端接口

申请试用

说明

申请试用，需填写姓名（最多输入待定个字符）、手机号码（需为1开头的11位数字）、寄送地址（最多输入待定个字符）、QQ号码（需为5~11位数字）、申请理由（至少输入20个汉字）。申请按钮固定在屏幕底部，不随页面滚动。点击”提交申请“，若各输入项均符合规则，则提示申请已受理并返回试用详情页。点击”提交申请“，若某个输入项不符合规则，则页面显示相应提示。

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
common_session_id	-	String	""	是
activityId	试用id	long	0	是
name	姓名	String	""	是
telNum	手机号码	String	""	是
address	寄送地址	long	0	是
qq	qq号码	int	0	是
reason	申请理由	String	0	是

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

4 晒物模块

4.1 晒物列表

http://trac.pc.com.cn/iphone/wiki/price_api#a1.2h优惠海淘发现晒物经验试用体验专题列表数据接口

4.2 晒物详情

http://trac.pc.com.cn/iphone/wiki/price_api#a1.4m单篇爆料晒物经验体验报告专题终端页Web

5 经验模块

5.1 经验列表

http://trac.pc.com.cn/iphone/wiki/price_api#a1.2h优惠海淘发现晒物经验试用体验专题列表数据接口

5.2 经验详情

http://trac.pc.com.cn/iphone/wiki/price_api#a1.4m单篇爆料晒物经验体验报告专题终端页Web

6 搜索模块

6.1 （h）搜索热词和筛选分类

mrobot接口：（mrobot补充）

接口名：

listTopicHotKeysAndTypes

后端接口

搜索热词

获取爆料分类

说明

获取热门标签和筛选分类使用场景：搜索初始界面

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  total: 20,
  data: {
    hotKeys: [
      {
        encodeKey: "%E8%85%95%E8%A1%A8",
        key: "腕表"
      },
      ...
    ]
    topicTypes: [
      {//from $topicType
        typeId: 1,
        name: "数码家电",
        level: 1
      },
      ...
    ]
  }
}

topicType

6.2 （m）搜索接口

mrobot接口：（mrobot补充）

接口名：

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: 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  // 是否白菜价合集
        },
        ...
    ],
    searchSectionResults: [
        {// from $sectionExtend
            value: 1,
            name: '海淘',
            count: 12  
        },
        ...
    ]
  }
}

$topic $sectionExtend

6.3 （h）搜索页电商列表

mrobot接口：（mrobot补充）

接口名：

listMalls

后端接口

获取电商列表

说明

获取电商列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
      {//from $mall
          mallId: 1, 
          mallName: "京东",
          url: "http://www.jd.com", // 电商URL
          seq: 12,  // 排序
          typeId: 1,  // 国内外电商  0国内电商 1国外电商
          areaType: 1,  // 地域类型  0其他电商 1美淘电商 2日淘电商
          imageUrl: "http://img.pc.com.cn/1.png"
      },
      ...
  ]
}

$mall

6.4 （l）搜索推荐

mrobot接口：（mrobot补充）

接口名：（mrobot接口补充后可删除掉）

searchKeywordHint

后端接口

搜索推荐

说明

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

提交方式

GET

参数

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

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

7 个人中心

7.1 （h）获取用户资料

mrobot接口：（mrobot补充）

接口名：

getUserInfo

后端接口

获取用户资料

说明

获取用户资料

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  data: {//from $user
          userId: 12,
          userName： "Jason",  // 用户名
          nickName： "Jason",  // 昵称
          email： "Jason@gg.cc",  // 电子邮件
          face: "http://img.a.b/1.png",  // 头像
          goldAmount:12,  // 金币
          score: 10,  // 积分
          levelId: 12,  // 等级Id
          experience: 12,  // 经验
          createAt:135212544845000,  // 创建时间
          pristige: 10,  // 威望值
          isBlack: 1,  // 是否黑名单
          purchasingGold:10,  // 钻石
          isPurchasing: 1,  // 1:代购商家 0:求购买家
        
     }
}

$user

7.2 （h）获取用户扩展信息

mrobot接口：（mrobot补充）

接口名：

getUserExtend

后端接口

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

说明

获取用户扩展信息

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  data: [
    {//from $userExtend and 获取试用总数
      topicNum: 1,
      favNum: 10,
      couponNum: 2    
      trialCount: 2
    }
  ]
}

$userExtend

7.3 （h）获取新的爆料数、评论数和试用数

mrobot接口：（mrobot补充）

接口名：

checkNewsPersonal

后端接口

获取用户某个时间之后的爆料数和评论数获取新通过和未通过的试用数（V2.0.0不需提供）

说明

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

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  data: {
    newTopicCount: 100,
    newCommentCount: 1,
    newSystemNoticeCount: 1,
    newTrialPassCount: 2,//（V2.0.0不需提供）
    newTrialNotPassCount: 2//（V2.0.0不需提供）
  }
}

$user

7.4 （m）获取我的爆料

mrobot接口：（mrobot补充）

接口名：

listMyTopics

后端接口

获取我的爆料

说明

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

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
        {//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  // 是否白菜价合集
        }
        ...
  ]
}

$topic

7.5 （m）获取收藏列表

mrobot接口：（mrobot补充）

接口名：

listMyCollects

后端接口

获取收藏列表

说明

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

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
      {//from $favorite
        favoriteId: 123,  // 收藏id
        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  // 是否白菜价合集,
        userId: 12,  // 收藏的用户Id
        createAt: 13625123531000
      }
  ]
}

$favorite

7.6 （m）我的试用（V2.0.0不需提供）

mrobot接口：（mrobot补充）

接口名：

listMyApplys

后端接口

我的试用

说明

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

提交方式

GET

参数

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

{
  status: 1,
  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封面"
    }
  ]
}

7.7 （m）我的优惠券列表

mrobot接口：（mrobot补充）

接口名：

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: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 20,
  total: 100,
  data: [
    {//from $gift
        couponId: 123,  // 优惠券Id
        giftId: 1,  // 礼品Id
        giftName: "京东卡",
        subGiftDesc: "好礼物",  // 个人中心相关礼品介绍截取100字符字段
        mallId:  12,  // 电商Id
        mallName: '京东',  // 电商名称
        imageUrl: "http://a.cn/1.png",  // 图片
        disCount: "满400减20",  // 优惠券额度
        cardNum: '1232',
        cardPassword: 's123sdssdfs54212',
        useDate: 13212457451000,  // 被领取时间
        createTime: 13251245124000,  // 创建时间
        expiryDate: 13621321521000,  // 有效期
        remainingDay:2  // 当前时间距离优惠券过期的天数
        expiry: 1  // 是否有效  true 有效  false 过期
    }
  ]
}

$gift

7.8 （h）检查签到状态

mrobot接口：（mrobot补充）

接口名：

checkSignInStatus

后端接口

检查签到状态

说明

检查签到状态

提交方式

GET

参数

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

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

7.9 （m）签到

mrobot接口：（mrobot补充）

接口名：

signInfForApp

后端接口

签到

说明

app端签到

提交方式

POST

参数

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

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

7.10 （l）添加爆料

mrobot接口：（mrobot补充）

接口名：

addTopic

后端接口

添加爆料

说明

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

提交方式

POST

参数

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

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

7.11 （l）推送设置内容定制列表

mrobot接口：（mrobot补充）

接口名：

subscription_list

后端接口

获取爆料分类

说明

推送设置内容定制列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "请求成功"
  data: {//from $topicType
    typeId: 1,
    name: '数码家电',
    level: 1  // 分类等级
  }
}

$topicType

7.12 （l）设置分类订阅

mrobot接口：（mrobot补充）

接口名：

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: 1,
  msg: "设置成功"
}

7.13 （l）获取用户的精准订阅列表（20150330不需提供）

mrobot接口：（mrobot补充）

接口名：

subscription_diy_list

后端接口

用户的精准订阅列表

说明

获取用户的精准订阅列表

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
pageNo	页数	int	1	否
pageSize	页面大小	int	20	否
token	设备id，未加密	string	""	否

{
  status: 1,
  msg: "请求成功"
  pageNo: 1,
  pageSize: 20,
  pageTotal: 2,
  total:40
  data: {//from $subscriptionSecond
    subscriptionId: 1,
    keywordId:12,
    keyword: "ipad"
  }
  ...
}

$subscriptionSecond

7.14 （l）添加精准订阅（20150330不需提供）

mrobot接口：（mrobot补充）

接口名：

add_subscription_second

后端接口

添加精准订阅

说明

设置分类订阅

提交方式

POST

参数

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

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

7.15 （l）删除精准订阅（20150330不需提供）

mrobot接口：（mrobot补充）

接口名：

del_subscription_second

后端接口

删除精准订阅

说明

删除精准订阅

提交方式

POST

参数

参数名	参数含义	类型	默认值	是否必须
addition	加密后的token	String	""	是
subscriptionId	关键词订阅id	int	0	是

{
  status: 1,
  msg: "删除成功"
}

7.16 （l）获取用户各个频道的收藏数量

mrobot接口：（mrobot补充）

接口名：

countCollects

后端接口

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

说明

获取收藏列表

提交方式

GET

参数

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

{
  status: 1,
  msg: "订阅成功",
  data: [
      {//from  $sectionExtend
        value: 1,
        name: '海淘',
        count: 12  
      },
      …
  ]
}

$sectionExtend

7.17 （l）系统和评论通知数量

mrobot接口：（mrobot补充）

接口名：

getSysNoticeAndCommentNum

后端接口

获得系统和评论通知数量

说明

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

提交方式

GET

参数

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

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

7.18 （l）获得系统通知

mrobot接口：（mrobot补充）

接口名：

listSystemNotice

后端接口

获得系统通知

说明

获得系统通知

提交方式

GET

参数

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

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

{
  status: 1,
  msg: "请求成功",
  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
    }
  ]
}

7.19 （l）我收到的评论

mrobot接口：（mrobot补充）

接口名：

listMyReceiveComment

后端接口

我收到的评论

说明

获得系统通知

提交方式

GET

参数

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

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 10,
  total: 20,
  pageTotal: 2,
  data: [
     {//from $receiveComment
        commentId: 37283120,
        currentFloor: 2,
        createAt: 1362154214000,
        isSupportPurchasing: 0,
        topicId: 80671,
        topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1410/28/c0/40244951_1414478236223_150x150.jpg",
        topicTitle: "双11预售：佳能 单反相机 1200D/18-55 套机",
        topicType: 0,  // 0发现，1优惠，2海淘，3晒物，4经验
        topicURLForPCWeb: "http://best.pconline.com.cn/faxian_80671.html",
        topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671",
        urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671",
        senderId: 1,  // 评论者ID，匿名回复则为0
        senderFace: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100",  // 发送者的头像
        senderNickName: "qz31244533",  // 发送者的昵称
        sendCommentContent: "怎么还要定金的呢",  // 发送的评论
        userFace: "http://i1.3conline.com/images/upload/upc/face/31/24/45/33/31244533_100x100",  // 被回复的头像
        userName: "arthinking",  // 被回复的昵称
        replyRefContent: ""看起来不错哦"",  // 被回复的内容
    }
  ]
}

$receiveComment

7.20 （l）我发出的评论

mrobot接口：（mrobot补充）

接口名：

listMySendComment

后端接口

我发出的评论

说明

获得用户发出的评论列表

提交方式

GET

参数

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

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

{
  status: 1,
  msg: "请求成功",
  pageNo: 1,
  pageSize: 10,
  total: 20,
  pageTotal: 2,
  data: [
     {//from $sendComment
        commentId: 37283120,
        currentFloor: 2,
        createAt: 1362123452000,
        isSupportPurchasing: 0,
        textCommentContent: "怎么还要定金的呢",
        topicId: 80671,
        topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1410/28/c0/40244951_1414478236223_150x150.jpg",
        topicTitle: "双11预售：佳能 单反相机 1200D/18-55 套机",
        topicType: 0,  // 0发现，1优惠，2海淘，3晒物，4经验
        topicURLForPCWeb: "http://best.pconline.com.cn/faxian_80671.html",
        topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671",
        urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671",
        senderNickName: "qz31244533",  // 发表评论者昵称
        senderFace: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100"  // 发表评论者头像
    }
  ]
}

$sendComment

8 iOS拓展相关

8.1 （l）最新爆料

mrobot接口：（mrobot补充）

接口名：

listNewTopics

后端接口

获取首页最新爆料

说明

用于iPhone端通知栏

提交方式

GET

参数

参数名	参数含义	类型	默认值	是否必须
limit	限制条数	int	0	是

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

{
  status: 1,
  msg: "请求成功",
  data: [
    {//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  // 是否白菜价合集
    }
    ...
  ]
}

Download in other formats:

Plain Text

Context Navigation

Table of Contents

聚超值2.0.0接口文档

一.基本约定

二.接口列表

电脑网应用端测试环境域名 v42.pconline.com.cn

电脑网应用端线上环境域名 best.pconline.com.cn

1 首页模块

1.1 （h）首页列表数据接口

1.2 （h）优惠、海淘、发现、晒物、经验、试用体验、专题列表数据接口

1.3 （h）获取用户最新动态变化

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

1.5 （m）判断用户是否已收藏爆料

1.6 （m）收藏

1.7 （m）取消收藏

1.8 （m）获取爆料赞和踩的数量

1.9 （m）赞或者踩

1.10 （l）爆料正文中图片集列表

1.11 （l）代购商家列表

1.12 （l）获取求购数 （20150326）

1.13 （l）求代购规则 （20150326）

1.14 （l）求代购

1.15 （l）优惠券终端页（Web）

1.14 （l）领取优惠券

2 发现模块

2.1 发现列表

2.2 发现详情

3 广场模块

3.1 （h）广场数据接口

3.2 （h）获取新试用数 （V2.0.0不需提供）

3.3 （h）专题列表

3.4 （h）商家活动列表

3.5 （h）优惠券列表

3.6 （h）获取用户金币和积分

3.7 （h）优惠券种类筛选页

3.8 （h）获取试用列表 （V2.0.0不需提供）

3.9 （h）获取试用类型列表 （V2.0.0不需提供）

3.10 （m）试用详情终端页（Web） （V2.0.0不需提供）

3.11 （m）判断用户是否已申请 （V2.0.0不需提供）

3.12 （l）申请试用 （V2.0.0不需提供）

4 晒物模块

4.1 晒物列表

4.2 晒物详情

5 经验模块

5.1 经验列表

5.2 经验详情

6 搜索模块

6.1 （h）搜索热词和筛选分类

6.2 （m）搜索接口

6.3 （h）搜索页电商列表

6.4 （l）搜索推荐

7 个人中心

7.1 （h）获取用户资料

7.2 （h）获取用户扩展信息

7.3 （h）获取新的爆料数、评论数和试用数

7.4 （m）获取我的爆料

7.5 （m）获取收藏列表

7.6 （m）我的试用 （V2.0.0不需提供）

7.7 （m）我的优惠券列表

7.8 （h）检查签到状态

7.9 （m）签到

7.10 （l）添加爆料

7.11 （l）推送设置内容定制列表

7.12 （l）设置分类订阅

7.13 （l）获取用户的精准订阅列表 （20150330不需提供）

7.14 （l）添加精准订阅 （20150330不需提供）

7.15 （l）删除精准订阅 （20150330不需提供）

7.16 （l）获取用户各个频道的收藏数量

7.17 （l）系统和评论通知数量

7.18 （l）获得系统通知

7.19 （l）我收到的评论

7.20 （l）我发出的评论

8 iOS拓展相关

8.1 （l）最新爆料

Download in other formats:

1.12 （l）获取求购数（20150326）

1.13 （l）求代购规则（20150326）

3.2 （h）获取新试用数（V2.0.0不需提供）

3.8 （h）获取试用列表（V2.0.0不需提供）

3.9 （h）获取试用类型列表（V2.0.0不需提供）

3.10 （m）试用详情终端页（Web）（V2.0.0不需提供）

3.11 （m）判断用户是否已申请（V2.0.0不需提供）

3.12 （l）申请试用（V2.0.0不需提供）

7.6 （m）我的试用（V2.0.0不需提供）

7.13 （l）获取用户的精准订阅列表（20150330不需提供）

7.14 （l）添加精准订阅（20150330不需提供）

7.15 （l）删除精准订阅（20150330不需提供）