wiki:app2.0/01_topic

爆料相关查找或更新接口

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

线上: /app/topic/cache/getTopicListOfTop.do

说明

热门爆料:指定 time 时间内,按照置顶优先,收藏数倒序,时间顺序倒序,不足用的情况下用最新的补充。

使用场景:用于广场

提交方式

GET

是否需要登录

false

缓存方式

接口缓存

缓存时间

300秒

参数

参数名 参数含义 类型 默认值 是否必须
limit获取条数int5
sectionId栏目id:栏目id,0 优惠 1 海淘 2 发现 3 晒物 4 经验 int0
time从该时间点算起的热门爆料,不足的情况下用最新的补充。long(时间戳 毫秒)当前时间

返回

result {
    status:1
    limit: 10,
    msg: '请求成功',
    data: [
        $topic
    ]
}

$topic


赞或者踩

线上: /app/topic/likeAndDislike.do

说明

使用场景:对爆料点赞或踩

提交方式

POST

是否需要登录

false

缓存方式

缓存时间

-

参数

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

返回

result {
    status: 1
        msg: '感谢您的投票'
}

栏目爆料列表

线上: /app/topic/cache/getTopicList.do

说明

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

使用场景:

提交方式

GET

是否需要登录

false

缓存方式

接口缓存

缓存时间

300秒

请求参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1
pageSize页面大小int10
sectionId栏目id:栏目id,0 优惠 1 海淘 2 发现 3 晒物 4 经验 100 支持官方代购爆料 34 原创int0

返回

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

$topic


爆料详细信息

线上: /app/topic/getTopicInfo.do

说明

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

提交方式

GET

是否需要登录

false

缓存方式

缓存时间

参数

参数名 参数含义 类型 默认值 是否必须
topicId爆料idint0
fontSizewap页面里面的字体大小int14
hd是否显示高清图:0 否, hdCover用_400x200 1 是,hdCover用_600x300 int0
showCustomAdCode是否显示自定义的广告代码 0:是 1:否int0

返回

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 经验
        }
}

$topic

$purchasing


获取爆料正文中的图片集

线上: /app/topic/cache/listTopicImages.do

说明

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

使用场景:用于浏览图模式

提交方式

GET

是否需要登录

false

缓存方式

接口缓存

缓存时间

300秒

参数

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

返回

result {
        status: 1
        msg: '请求成功',
        data:[
            index: 1,  // 第几张图片
            url:'http://img/pc.com.cn/1.png'
        ]
}

获取我的爆料

线上: /app/my/topic/listMyTopic.do

说明

获取我的爆料

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

提交方式

GET

是否需要登录

true

缓存方式

缓存时间

-

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1
pageSize页面大小int10
common_session_id登录sessionIdStriingnull
status爆料审核状态:1 审核通过 2 待审核(包括:待审核和正在处理)或者审核不通过(包括审核不通过,禁用和需修改)int1

返回

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

$topic


添加爆料

线上: /app/topic/addTopic.do

说明

添加爆料

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

提交方式

POST

是否需要登录

true

缓存方式

缓存时间

-

参数

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

返回

result {
        status: 1 //1爆料成功,-1爆料失败
        msg: '提交成功'
}

获取爆料赞和踩的数量

线上: /app/topic/getTopicLikeAndDislikeCount.do

说明

获取爆料赞和踩的数量

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

提交方式

GET

是否需要登录

false

缓存方式

缓存时间

-

参数

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

返回

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

获取首页最新爆料

线上: /app/topic/cache/getNotificationBarInfo.do

说明

获取首页最新爆料

提交方式

GET

是否需要登录

false

缓存方式

缓存时间

-

参数

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

返回

result {
        status: 1
        msg: '请求成功',
        data:{
            $topic          
        }
}

$topic


获取置底的爆料

线上: /app/topic/cache/getTopicListOfFixTail.do

测试: http://v42.pconline.com.cn/app/topic/cache/getTopicListOfFixTail.do?pageNo=1

说明

获取置底的爆料

提交方式

GET

是否需要登录

false

缓存方式

接口缓存

缓存时间

300秒

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页码int1

返回

result {
        status: 1
        pageNo: 1
        pageSize: 20,
        total: 1,
        pageTotal: 1,
        msg: '请求成功',
        data: [$indexVo]
}

 $indexVo