[[TOC]]

= 收藏 =

== 收藏 ==

> 线上：[http://best.pconline.com.cn/app/my/collect/collectForApp.do?topicId=19&common_session_id=56D39281DCC5AA42DC3D98B1A2E48B9A /app/my/collect/collectForApp.do]

**说明**

> 收藏

**提交方式**

> POST

**是否需要登录**

> 是

**缓存方式**

> 无

**缓存时间**

> -

**参数**

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

**返回**

{{{#!java
result {
    status: 1,  
    msg: '收藏成功'
}
result {
    status: -1, //对应三种状态 
    msg: '收藏失败'或 '你已收藏过该爆料了' 或 '收藏的文章不存在或已删除'
}
}}}

----------

== 取消收藏 ==

> 线上：[http://best.pconline.com.cn/app/my/collect/decollectForApp.do?topicIds=18&common_session_id=56D39281DCC5AA42DC3D98B1A2E48B9A /app/my/collect/decollectForApp.do]

**说明**

> 取消收藏

**提交方式**

> POST

**是否需要登录**

> 是

**缓存方式**

> 无

**缓存时间**

> -

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||common_session_id||-||String||""||是||
||topicIds||爆料id字符串，英文逗号分隔，如：1,2,3||String||""||是||

**返回**

{{{#!java
result {
    status: 1,  
    msg: '取消收藏成功',
    data: {
        count: 1  // 成功取消的收藏数
    }
}
}}}

----------

== 获取收藏列表 ==

> 线上：[http://best.pconline.com.cn/app/my/collect/listCollects.do?index=1&pageNo=1&pageSize=10&common_session_id=56D39281DCC5AA42DC3D98B1A2E48B9A /app/my/collect/listCollects.do]

**说明**

> 获取收藏列表

**提交方式**

> GET

**是否需要登录**

> 是

**缓存方式**

> 无

**缓存时间**

> -

**参数**

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

**返回**

{{{#!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]  

----------

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

> 线上：[http://best.pconline.com.cn/app/my/collect/countCollects.do?common_session_id=56D39281DCC5AA42DC3D98B1A2E48B9A /app/my/collect/countCollects.do]

**说明**

> 获取各个栏目的收藏数量

**提交方式**

> GET

**是否需要登录**

> 是

**缓存方式**

> 无

**缓存时间**

> -

**参数**

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

**返回**

{{{#!java
result {
    status： 1
	msg: '请求成功',
	data: [$sectionExtend]
}
}}}

[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#栏目搜索结果 $sectionExtend] 

----------

== 获取某个爆料的收藏数量 ==

> 线上：[http://best.pconline.com.cn/app/collect/getTopicCollectCount.do?common_session_id=&topicId=104400 /app/collect/getTopicCollectCount.do]

**说明**

> 获取某个爆料的收藏数量，如果传递了common_session_id，则这里可以返回当前用户是否已收藏爆料。

**提交方式**

> GET

**是否需要登录**

> 否

**缓存方式**

> 无

**缓存时间**

> -

**参数**

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

**返回**

{{{#!java
result {
    status： 1
    msg: '请求成功',
    data: {
	hasCollect: 0,  // 0 表示未收藏   1 表示已收藏
	count: 12
    }
}
}}}

== 判断用户是否已收藏爆料 ==

> 线上：[http://best.pconline.com.cn/app/collect/checkTopicCollectStatus.do?common_session_id=&topicId=104400 /app/my/collect/checkTopicCollectStatus.do]

**说明**

> 获取某个爆料的收藏数量

**提交方式**

> GET

**是否需要登录**

> 是

**缓存方式**

> 无

**缓存时间**

> -

**参数**

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

**返回**

{{{#!java
result {
    status： 1
    msg: '请求成功',
    data: {
	hasCollect: 0  // 0 表示未收藏   1 表示已收藏
    }
}
}}}