[[TOC]] = 爆料相关查找或更新接口 = == 按时间获取最近的热门爆料== > 线上：[http://best.pconline.com.cn/app/topic/cache/getTopicListOfTop.do?sectionId=2 /app/topic/cache/getTopicListOfTop.do] **说明** > 热门爆料：指定 time 时间内，按照置顶优先，收藏数倒序，时间顺序倒序，不足用的情况下用最新的补充。 > ''使用场景''：用于广场 **提交方式** > GET **是否需要登录** > false **缓存方式** > 接口缓存 **缓存时间** > 300秒 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||limit||获取条数||int||5||否|| ||sectionId||栏目id:栏目id，0 优惠 1 海淘 2 发现 3 晒物 4 经验 ||int||0||是|| ||time||从该时间点算起的热门爆料，不足的情况下用最新的补充。||long(时间戳毫秒)||当前时间||是|| **返回** {{{#!java result { status:1 limit： 10, msg: '请求成功', data: [ $topic ] } }}} [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] ---------- == 赞或者踩 == > 线上：[http://best.pconline.com.cn/app/topic/likeAndDislike.do?topicId=120371 /app/topic/likeAndDislike.do] **说明** > ''使用场景''：对爆料点赞或踩 **提交方式** > POST **是否需要登录** > false **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||topicId||爆料id||int||0||是|| ||operate||操作：0 赞 1 踩||int||0||是|| **返回** {{{#!java result { status： 1 msg: '感谢您的投票' } }}} ---------- == 栏目爆料列表 == > 线上：[http://best.pconline.com.cn/app/topic/cache/getTopicList.do?pageNo=1&pageSize=10§ionId=1 /app/topic/cache/getTopicList.do] **说明** > 根据传入的栏目id，获取对应的爆料 > 使用场景： **提交方式** > GET **是否需要登录** > false **缓存方式** > 接口缓存 **缓存时间** > 300秒 **请求参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||10||是|| ||sectionId||栏目id:栏目id，0 优惠 1 海淘 2 发现 3 晒物 4 经验 100 支持官方代购爆料 34 原创||int||0||是|| **返回** {{{#!java result { status: 1 pageNo： 1 pageSize： 20, total: 100, pageTotal: 5, msg: '请求成功', data:[ $topic ] } }}} [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] ---------- == 爆料详细信息 == > 线上：[http://best.pconline.com.cn/app/topic/getTopicInfo.do?topicId=12123 /app/topic/getTopicInfo.do] **说明** > 使用场景：根据id查找单篇爆料或者晒物、经验、体验报告、专题等，一般用于终端详情页 **提交方式** > GET **是否需要登录** > false **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||topicId||爆料id||int||0||是|| ||fontSize||wap页面里面的字体大小||int||14||是|| ||hd||是否显示高清图：0 否， hdCover用_400x200 1 是，hdCover用_600x300 ||int||0||否|| ||showCustomAdCode||是否显示自定义的广告代码 0:是 1:否||int||0||否|| **返回** {{{#!java result: { status: 1 msg: '请求成功', data:{ topic:$topic, fontSize: 14, topicText:"爆料内容", newestPurchasings: $purchasing, // 最新的一个代购 bestBuyLink:"bestbuy://topic-1.cc", // 直达链接，可能是自定义的协议或者普通的url topSection: 1 // bestBuyLink对应的爆料类型 0 优惠 1 海淘 2 发现 3 晒物 4 经验 } } }}} [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#代购商家 $purchasing] ---------- == 获取爆料正文中的图片集 == > 线上：[http://best.pconline.com.cn/app/topic/cache/listTopicImages.do?topicId=120287 /app/topic/cache/listTopicImages.do] **说明** > 从终端页中获取到所有上传的图片 > 使用场景：用于浏览图模式 **提交方式** > GET **是否需要登录** > false **缓存方式** > 接口缓存 **缓存时间** > 300秒 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||topicId||爆料id||int||0||是|| **返回** {{{#!java result { status: 1 msg: '请求成功', data:[ index: 1, // 第几张图片 url：'http://img/pc.com.cn/1.png' ] } }}} ---------- == 获取我的爆料 == > 线上：[http://best.pconline.com.cn/app/my/topic/listMyTopic.do?common_session_id=291AC3A5D1FB4F8E0FD482528B353B84&status=2&pageNo=1 /app/my/topic/listMyTopic.do] **说明** > 获取我的爆料 > 使用场景：用于网友个人中心获取网友的爆料列表 **提交方式** > GET **是否需要登录** > true **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||10||是|| ||common_session_id||登录sessionId||Striing||null||是|| ||status||爆料审核状态：1 审核通过 2 待审核（包括：待审核和正在处理）或者审核不通过（包括审核不通过，禁用和需修改）||int||1||是|| **返回** {{{#!java result { status: 1 pageNo： 1 pageSize： 20, total: 100, pageTotal: 5, msg: '请求成功', data:[ $topic ] } }}} [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] ---------- == 添加爆料 == > 线上：[http://best.pconline.com.cn/app/topic/addTopic.do?email=sadf@qq.com&fromUrl=http://www.baidu.com&content=afasdf /app/topic/addTopic.do] **说明** > 添加爆料 > 使用场景：用于网友个人中心增加爆料功能 **提交方式** > POST **是否需要登录** > true **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||common_session_id||登录sessionId||String||null||否|| ||email||电子邮件||String||null||如果common_session_id为空，则必须输入email|| ||fromUrl||来源||String||null||是|| ||content||用户推荐理由||String||null||是|| **返回** {{{#!java result { status: 1 //1爆料成功，-1爆料失败 msg: '提交成功' } }}} ---------- == 获取爆料赞和踩的数量 == > 线上：[http://best.pconline.com.cn/app/topic/getTopicLikeAndDislikeCount.do?topicId=120286 /app/topic/getTopicLikeAndDislikeCount.do] **说明** > 获取爆料赞和踩的数量 > 使用场景：一般用于终端页显示爆料的赞和踩的数量 **提交方式** > GET **是否需要登录** > false **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||topicId||爆料id||int||0||是|| **返回** {{{#!java result { status: 1 msg: '请求成功', data:{ goodCount: 12, badCount: 1, isVoted: 0 // 是否已投票 1 已投票 0 未投票 } } }}} ---------- == 获取首页最新爆料 == > 线上：[http://best.pconline.com.cn/app/topic/cache/getNotificationBarInfo.do?limit=3 /app/topic/cache/getNotificationBarInfo.do] **说明** > 获取首页最新爆料 **提交方式** > GET **是否需要登录** > false **缓存方式** > 无 **缓存时间** > - **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||limit||限制条数||int||5||是|| **返回** {{{#!java result { status: 1 msg: '请求成功', data:{ $topic } } }}} [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] ---------- == 获取置底的爆料 == > 线上：[http://best.pconline.com.cn/app/topic/cache/getTopicListOfFixTail.do?pageNo=1 /app/topic/cache/getTopicListOfFixTail.do] > 测试：[http://v42.pconline.com.cn/app/topic/cache/getTopicListOfFixTail.do?pageNo=1 http://v42.pconline.com.cn/app/topic/cache/getTopicListOfFixTail.do?pageNo=1] **说明** > 获取置底的爆料 **提交方式** > GET **是否需要登录** > false **缓存方式** > 接口缓存 **缓存时间** > 300秒 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页码||int||1||是|| **返回** {{{#!java result { status: 1 pageNo： 1 pageSize： 20, total: 1, pageTotal: 1, msg: '请求成功', data: [$indexVo] } }}} [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/object_properties#首页VO $indexVo]