爆料相关查找或更新接口
按时间获取最近的热门爆料
说明
热门爆料:指定 time 时间内,按照置顶优先,收藏数倒序,时间顺序倒序,不足用的情况下用最新的补充。
使用场景:用于广场
提交方式
GET
是否需要登录
false
缓存方式
接口缓存
缓存时间
300秒
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| limit | 获取条数 | int | 5 | 否 |
| sectionId | 栏目id:栏目id,0 优惠 1 海淘 2 发现 3 晒物 4 经验 | int | 0 | 是 |
| time | 从该时间点算起的热门爆料,不足的情况下用最新的补充。 | long(时间戳 毫秒) | 当前时间 | 是 |
返回
result {
status:1
limit: 10,
msg: '请求成功',
data: [
$topic
]
}
赞或者踩
说明
使用场景:对爆料点赞或踩
提交方式
POST
是否需要登录
false
缓存方式
无
缓存时间
-
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| topicId | 爆料id | int | 0 | 是 |
| operate | 操作:0 赞 1 踩 | int | 0 | 是 |
返回
result {
status: 1
msg: '感谢您的投票'
}
栏目爆料列表
说明
根据传入的栏目id,获取对应的爆料
使用场景:
提交方式
GET
是否需要登录
false
缓存方式
接口缓存
缓存时间
300秒
请求参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 |
| pageSize | 页面大小 | int | 10 | 是 |
| sectionId | 栏目id:栏目id,0 优惠 1 海淘 2 发现 3 晒物 4 经验 100 支持官方代购爆料 34 原创 | int | 0 | 是 |
返回
result {
status: 1
pageNo: 1
pageSize: 20,
total: 100,
pageTotal: 5,
msg: '请求成功',
data:[
$topic
]
}
爆料详细信息
说明
使用场景:根据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 | 否 |
返回
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 经验
}
}
获取爆料正文中的图片集
说明
从终端页中获取到所有上传的图片
使用场景:用于浏览图模式
提交方式
GET
是否需要登录
false
缓存方式
接口缓存
缓存时间
300秒
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| topicId | 爆料id | int | 0 | 是 |
返回
result {
status: 1
msg: '请求成功',
data:[
index: 1, // 第几张图片
url:'http://img/pc.com.cn/1.png'
]
}
获取我的爆料
说明
获取我的爆料
使用场景:用于网友个人中心获取网友的爆料列表
提交方式
GET
是否需要登录
true
缓存方式
无
缓存时间
-
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 |
| pageSize | 页面大小 | int | 10 | 是 |
| common_session_id | 登录sessionId | Striing | null | 是 |
| status | 爆料审核状态:1 审核通过 2 待审核(包括:待审核和正在处理)或者审核不通过(包括审核不通过,禁用和需修改) | int | 1 | 是 |
返回
result {
status: 1
pageNo: 1
pageSize: 20,
total: 100,
pageTotal: 5,
msg: '请求成功',
data:[
$topic
]
}
添加爆料
说明
添加爆料
使用场景:用于网友个人中心增加爆料功能
提交方式
POST
是否需要登录
true
缓存方式
无
缓存时间
-
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| common_session_id | 登录sessionId | String | null | 否 |
| 电子邮件 | String | null | 如果common_session_id为空,则必须输入email | |
| fromUrl | 来源 | String | null | 是 |
| content | 用户推荐理由 | String | null | 是 |
返回
result {
status: 1 //1爆料成功,-1爆料失败
msg: '提交成功'
}
获取爆料赞和踩的数量
说明
获取爆料赞和踩的数量
使用场景:一般用于终端页显示爆料的赞和踩的数量
提交方式
GET
是否需要登录
false
缓存方式
无
缓存时间
-
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| topicId | 爆料id | int | 0 | 是 |
返回
result {
status: 1
msg: '请求成功',
data:{
goodCount: 12,
badCount: 1,
isVoted: 0 // 是否已投票 1 已投票 0 未投票
}
}
获取首页最新爆料
说明
获取首页最新爆料
提交方式
GET
是否需要登录
false
缓存方式
无
缓存时间
-
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| limit | 限制条数 | int | 5 | 是 |
返回
result {
status: 1
msg: '请求成功',
data:{
$topic
}
}
获取置底的爆料
测试: http://v42.pconline.com.cn/app/topic/cache/getTopicListOfFixTail.do?pageNo=1
说明
获取置底的爆料
提交方式
GET
是否需要登录
false
缓存方式
接口缓存
缓存时间
300秒
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| pageNo | 页码 | int | 1 | 是 |
返回
result {
status: 1
pageNo: 1
pageSize: 20,
total: 1,
pageTotal: 1,
msg: '请求成功',
data: [$indexVo]
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)