[[TOC]]

= 爆料相关查找或更新接口 = 

== 按时间获取最近的热门爆料== 

> /app/topic/cache/getTopicListOfTop.do

**说明**

> 根据栏目id按时间获取最近的热门爆料

> ''使用场景''：用于广场

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||sectionId||栏目id:栏目id，0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题||int||0||是||
||time||从该时间点算起的热门爆料||long(时间戳 秒)||当前时间||是||

**返回**

{{{#!java
result {
    pageNo： 1,
    pageSize: 10,
    total: 20,
	pageTotal: 2,
	msg: '请求成功',
	data: [
            $topic
	]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic]

----------

== 赞或者踩 ==

> app/topic/likeAndDislike.do

**说明**

> ''使用场景''：对爆料点赞或踩

**提交方式**

> POST

**参数**

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

**返回**

{{{#!java
result {
    status： 1
	msg: '感谢您的投票'
}
}}}

----------

== 栏目爆料列表 ==

> app/topic/cache/getTopicList.do

**说明**    

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

> 使用场景：

**提交方式**

> GET

**请求参数**

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

**返回**

{{{#!java
result {
	status: 1
	pageNo： 1
	pageSize： 20,
	total: 100,
	pageTotal: 5,
	msg: '请求成功',
	sectionId: 2,
	data:[
	    $topic
	]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic]

----------

== 爆料详细信息 ==

> app/topic/getTopicInfo.do

**说明**

> 使用场景：根据id查找单篇爆料或者晒物、经验、体验报告、专题等，一般用于终端详情页

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||topicId||爆料id||int||0||是||
||fontSize||wap页面里面的字体大小||int||14||是||

**返回**

{{{#!java
result: {
	status: 1
	msg: '请求成功',
	data:{
            topic:$topic,
            topicText:"爆料内容",
            newestPurchasings: [$purchasing],  // 最新代购列表，显示前四个
            bestBuyLink:"bestbuy://topic-1.cc"  // 直达链接，可能是自定义的协议或者普通的url
        }
}
}}}
[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]

----------

== 获取爆料正文中的图片集 ==

> app/topic/cache/listTopicImages.do

**说明**

> 从终端页中获取到所有上传的图片

> 使用场景：用于浏览图模式

**提交方式**

> GET

**参数**

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

**返回**
{{{#!java
result {
	status: 1
	total: 100,
	msg: '请求成功',
	data:[
            index: 1,  // 第几张图片
	    url：'http://img/pc.com.cn/1.png'
	]
}
}}}

----------

== 获取我的爆料 ==

> /app/my/topic/cache/listMyTopic.do

**说明**

> 获取我的爆料

> 使用场景：用于网友个人中心获取网友的爆料列表

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||pageNo||页数||int||1||是||
||pageSize||页面大小||int||10||是||
||common_session_id||登录sessionId||Striing||null||是||
||status||爆料审核状态：-1 审核未通过   1 已审  0 待审核||String(如 0,1)||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]

----------

== 添加爆料 == 

> app/topic/addTopic.do

**说明**

> 添加爆料

> 使用场景：用于网友个人中心增加爆料功能

**提交方式**

> POST

**参数**

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

**返回**

{{{#!java
result {
	status: 1
	msg: '提交成功'
}
}}}

----------

== 获取爆料赞和踩的数量 ==

> app/topic/getTopicLikeAndDislikeCount.do

**说明**

> 获取爆料赞和踩的数量

> 使用场景：一般用于终端页显示爆料的赞和踩的数量

**提交方式**

> GET

**参数**

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

**返回**

{{{#!java
result {
	status: 1
	msg: '请求成功',
        data:{
	    goodCount: 12,
	    badCount: 1,
	    isVoted: 0  // 是否已投票            
        }
}
}}}