wiki:intf

Context Navigation

Version 141 (modified by dingjianyong, 12 years ago) (diff)
--

接口列表

intf/common

_topics.jsp 论坛主题列表接口(重要)

参数

subsite=false;是否只查单个版块，默认为false。
当subsite=false时，支持以下参数：

noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。
type=new;查询类型。目前支持new(2日内新帖),new_act(2日内活动帖),new_vote(2日内投票帖), hot_day(2日内热帖),hot_week(7日内热帖),hot_month(30日内热帖),hot_all(全部热帖), pick_day(2日内精华帖),pick_week(7日内精华帖),pick_month(30日内精华帖),pick_all(全部精华帖)
pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型
orderby=;查询类型为hot时，默认按回复数(replyCount)排序，要按点击数(view)排序就需要加此配置。查询类型为pick时，默认按发帖时间(createAt)排序，要按点击数(view)排序就需要加此配置。

当subsite=true时，支持以下参数：

forums=;只能接受一个版块ID，多个版块取第一个
top=3;置顶帖条数
days=2;从多少天前的数据开始查询，可填任意整数
type=new;可填new,hot,pick,top
extId=;6为达人牛帖(暂未实现)
reply=-1;回复数大于等于多少，为-1时没有限制
replyMax=-1;回复数最大是少于多少，为-1时没有限制
topicType=;话题类别，默认为不填
topicTypeUTF8=;话题类别UTF8格式处理，默认为不填

count=10;列出条数
display=json;显示方式，支持json和ssi
maxLength=240;帖子内容最大长度,默认240个英文字符,相当于120个汉字.（目前只有json时生效）
faceWidth:需要返回头像时设定头像的宽度[[BR]] callback=;当display=json时使用的回调函数名称

说明

可以查看4种形式的主题列表，最新，顶置，最热，精华。根据subsite参数确定从哪个表查找
如果subsite=true，直接从bbs7_topic_xx表中读取数据
如果subsite=false，最新的主题从bbs7_new_topic里查找,最热的主题从bbs7_hot_topic,bbs7_hot_topic7,bbs7_hot_topic30,bbs7_hot_topic_all里查找，精华的主题从bbs7_pick里查找。

输出内容包括：forumId，forumName，forumUrl，userId，userName，userUrl，topicId，title，message，rewardAmount，rewardRemain，replyCount，viewCount，createAt，lastPostAt，topicUrl，rate，rateReply，type。如果type=new，则还需要返回face，dealedTime

_topic.jsp 根据主题ID，获取主题信息

参数

tid=; 要查询的主题ID
callback=; 回调函数名称

说明

返回数据类型为JSON
输出格式样例：{"forum":{"forumId":版块ID,"name":"版块名称","url":"版块URL"},"postList":[{"author":{"authorId":作者ID,"name":"作者名称","nickname":"作者昵称","url":"作者个人中心URL"},"createAt":"创建时间","floor":楼层,"message":"主题内容","postId":帖子ID,"topicId":主题ID,"url":"帖子URL"}],"replyCount":回复数,"title":"帖子标题","topicId":主题ID,"url":"主题URL","viewCount":查看数}

_users.jsp 获取用户数据

参数 pageType：为user时，返回发帖数排行用户JSON(需要传type参数);为lastpost时，返回最后发帖的用户JSON，否则返回用户的基本信息(需要传userIds)
days：多少天内的数据(针对typeType=user，默认1天，当天不计)
pageSize：返回结果数（默认50）
userIds：用户ID
faceWidth：用户头像宽度(type=pick时需要传)
type：“week”为本周贴数，“pick”为全部精华帖,需要返回头像(默认是查精华)
callback：回调函数
说明返货json数据格式，包括用户ID、用户名、昵称、用户个人中心url地址、头像宽度、发主题数、回帖数；接口缓存10小时
数据格式样例(pageType=user)：[{"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}, {"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}]

_topicRepliesJson.jsp 根据主题ID，按顺序分页显示回帖(重要）

参数

tid=; 要查询的主题ID
len=200; 内容显示的字数，过滤掉UBB，默认200字符，如果负数则表示不截取，显示完整的(显示完整内容时会把ubb转换成html)
pageNo=1; 页数
pageSize=10; 每页显示数量
callback=; 回调函数名称

说明

返回数据类型为JSON
输出格式样例：({"forum":{"forumId":版块ID,"name":"版块名称","url":"版块URL"},"pageCount":页面总数,"pageNo":页面号码,"pageSize":页面大小,"postList":[{"author":{"authorId":作者ID,"name":"作者名称","nickname":"作者昵称","url":"作者URL"},"createAt":"创建时间","floor":楼层,"message":"主帖子内容","postId":帖子ID,"topicId":主题ID,"url":"帖子URL"}],"replyCount":回复数量,"title":"标题","topicId":主题ID,"total":帖子数量,"url":"主题URL","viewCount":查看数});

_forumNames.jsp 取版块名称
_contributionUsers.jsp 论坛获取全站用户贡献值排行榜接口

参数 aa：显示数据的个数，默认值是10
type：输出地格式默认是ssi,还有json可选
callback：回调函数
说明输出结果包括用户ID、用户名、昵称、用户个人中心url地址；用json输出；接口缓存10小时
输出格式样例：[{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名},{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名}]

_block_forums.jsp 给果派论坛首页使用（重要）

参数 fids：版块id以,逗号组成
callback：回调函数
说明根据fids，检索各个板块的今天发帖量、主题总数、回帖总数及最后一个主题的详细，输出格式样例：[{"forumId":1,"count":1,"topics":1,"posts":1},"lastTopicAuthor"{"lastTopicId":1,"lastTopicTitle":1,"lastTopicUrl":1}]

_forumTopics.jsp(it) （重要）

参数 fid：版块id
pageNo：页号
pageSize：分页大小
callback：回调函数
说明根据fid，按发帖时间倒序分页显示Topic，用JSON输出，有分页

_postCountByHotForums.jsp(it)

说明本接口用于显示论坛板块发帖量排行榜，显示昨天的发帖量排行功能同_hotForums.jsp,去掉了js显示

_postsByUser.jsp(it)

参数 uid：用户id
type=topic：reply/topic
count=10：显示条数
maxLength=240：内容最大长度
说明将_myPosts.jsp和_user-posts.jsp整合成该页面，并将返回格式统一为json

_todayPostCountByForum.jsp(it) （重要）

参数 fids: 多个fid用逗号分隔
说明同_forum-today-post.jsp

_top_user.jsp(it)

参数 type: pick/water/topic/post/contribution days: 统计多少天之内的 count=10: 显示条数 display=json: json/ssi callback: 回调函数
说明本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。

_topicReplies.jsp(it) （重要）

参数 tag: 用于替换的页面元素id tid: 主题id,非空 count=10: 显示条数 cl=150: 帖子内容显示字数
说明论坛主题和其下回复页面接口

_topicRepliesList.jsp(it)（重要）

参数 tid: 主题id,非空 callback: 回调函数
说明返回给diy精品用的接口返回例:cb({"topicList":[{"createAt":"13-05-03 10:33","forumName":"一级版块","forumUrl":" http://localhost.pcauto.com.cn/bbs7/forum- 2.html","nickname":"fit10","replyCount":1,"topicId":372,"url":" http://dev4.pconline.com.cn:8081/826717","viewCount":1}]});[[BR]][[BR]]

_topicReplyCountJson.jsp(it)

参数 tid: 主题id,非空 callback: 回调函数
说明根据主题ID查找主题回帖数返回例:cb({"count":1} );

_userList.jsp(it)

参数 type: pick/water/topic/post/contribution days: 统计多少天之内的 count=10: 显示条数 display=json: json/ssi callback: 回调函数
说明本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。同_score-member.jsp

intf/special

_active_user.jsp 得到论坛的活跃好友ID

参数 size：从数据库里拿出的活跃好友个数
returnsize：返回的个数
callback：回调函数
说明先从bbs7_user 按lastpostat排序(7天内)，取前size个,最后随机返回returnsize个用户的ID；接口缓存10小时
输出格式样例：{}

_searchHTML.jsp 通过关键字或标题搜索帖子内容,结果从快搜得到

参数

searchWord=; 关键字
pageNo=1; 页数
pageSize=1; 每页显示数量
searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容

说明

如果从快速得到的结果为空，则返回最新的一条精华数据

_topics_activity.jsp 现在用于摄影部落chinajoy活动参数

fid=; 版块id
startDate=1; 活动开始时间yyyyMMdd
containimage=1; 是否只出包含图片的
type=1; 没用到
isFilter=; 是否过滤关键字
titleFilter=; 标题过滤字,需要设置isFilter=1才生效
orderby=createTime; 排序
lineSize=3; 一行显示数
pageNo=1; 页号
pageSize=9; 每页显示数
imgWidth=; 图片宽度
imgHeight=; 图片高度
css=; 引用样式表路径,有默认
display=js/json; 显示方式,默认为js
callback=; 回调函数

说明

读论坛图片接口修改技术需求

_autoForumAdmin.jsp 论坛根据车系id返回对应版块下的版主、版副、嘉宾接口

参数 sids：车系ID，多个ID半角逗号分隔(需要在后台板块车系对应插件配置中配置对应关系)
callback：回调函数
说明返回json格式；接口缓存10小时
输出格式样例：{"forumAdmin1"（版主）:[{"userId":用户ID,"name":用户名,"nickName":昵称}],"forumAdmin2"（版副）:[],"forumAdmin3"（嘉宾）:[],"forumId":板块ID,"sid":车系ID}

_baby_120827.jsp 亲子网论坛获取用户回帖接口

参数 uid=25315560l：用户ID
tid=1191267l：主题ID
maxlength：内容显示最大长度
callback：回调函数
说明考虑性能关系只在该用户的最新50条回帖里找如果该用户最新50条回帖都不是该贴内的则不会返回结果；接口缓存720小时

_showCar_cache.jsp vip插件接口的缓存接口

说明 bbs7已不需要此接口

intf/user

_topics.jsp 我的主题（重要）

参数 userId：用户ID
pageSize：每页显示多少条（默认50）
pageNo：第几页
maxLength：帖子内容显示最大长度
callback：回调函数
说明返回json格式；结果会过滤已删除;接口缓存10小时
输出结果样例：{"list":[{"topicId":主题id,"title":主题标题,"message":内容,"url":主题url,"userName":昵称,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,pick:精华,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数(未过滤前)}[[BR]][[BR]]

_posts.jsp 我的回复（重要）

参数 userId：用户ID
pageSize：每页显示多少条（默认50）
pageNo：第几页
maxLength: 回复内容显示最大长度
callback：回调函数
说明返回json格式；结果会过滤已删除及未审核;接口缓存10小时
输出结果样例：{"list":[{"topicId":主题id,"title":主题标题,"topicUrl":主题URL,"url":回复本楼URL,"floor":所处楼层,"content":回复内容,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}

_picks.jsp 我的精华帖（重要）

参数 userId：用户ID
pageSize：每页显示多少条（默认50）
pageNo：第几页
callback：回调函数
说明返回json格式；结果会过滤已删除;接口缓存10小时
输出结果样例：{"list":[{"title":主题标题,"url":主题url,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}

_favForums.jsp 我收藏的版块（重要）

参数 userId：用户ID
pageSize：每页显示多少条（默认50）
pageNo：第几页
callback：回调函数
说明返回json格式；没有接口缓存;如果userId不传，则查找当前登录用户的收藏板块
输出结果样例：{"list":[{"favoriteId":收藏ID,"forumId":板块ID,"name":板块名称,"url":板块地址}],"listCount":记录数}

_favTopics.jsp 我收藏的帖子（重要）

参数 userId：用户ID
pageSize：每页显示多少条（默认50）
pageNo：第几页
callback：回调函数
说明返回json格式；没有接口缓存
输出结果样例：{"list":[{"favoriteId":收藏ID,"forumName":板块名称,"forumUrl":板块链接,"isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":最后发表时间,"replyCount":回复数,"title":标题,"topicId":主题ID,"url":主题链接,"viewCount":查看数}],"listCount":记录数}

_idTopics.jsp 根据ID获取主题对象列表

参数

ids=; 要查询的主题ID，多个主题ID用半角逗号分隔
callback=; 回调函数

说明

返回数据类型为JSON

输出结果样例：{"list":[{"authorName":"作者名称","authorNickName":"作者昵称","authorUrl":"作者个人中心链接","createAt":"创建时间","forumName":"版块名称","forumUrl":"版块URL","isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":"最后回复时间","replyCount":回复数,"title":"标题","topicId":主题ID,"url":"主题URL","viewCount":查看数}],"listCount":列表大小}

_extIds.jsp

参数

userId=;要查询的用户id
extId=;bbs6中的extId种类,1~6,需要导完旧数据才可查
dateTrom,dateTo=;yyyy-MM-dd格式日期
pageNo,pageSize=;分页参数
callback=;回调函数名

说明

用于查询兼容bbs6里用户的扩展贴,json格式

_setVip.jsp

参数 uid：用户ID
action：操作(checkVip:检查车主认证状态)[[BR]] status：状态(1：通过认证；-1：被驳回；2：提交申请成功；-2：被取消资格)
reason：原因
说明返回JSON格式；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。
输出结果样例：{"desc":"request 描述","status":状态}

_updateSign.jsp （重要）

参数 uid：用户ID
viewSign：是否显示用户签名档，true为显示
sign：签名档内容，签名档不能超过1200个字
reason：原因
说明异步调用，用于修改用户的签名档（如果用户已有签名档则修改原有的，如果没有则新增签名档）。

输出结果样例：{"desc":"request 描述","status":状态}

_updateMedal.jsp

参数 uid：用户ID,可以多个，每个直接用逗号分隔
medalId：勋章ID，可以多个，每个直接用逗号分隔
action：默认为用户添加勋章，如果action=delete，则取消用户勋章
reason：原因
说明异步调用，用于修改用户的勋章（可以为授勋或取消勋章）。

输出结果样例：{"desc":"描述","status":状态}

_userTopicReplies.jsp

参数 fid：版块ID
startdate：统计开始时间，long类型的时间数值
enddate：统计结束时间，long类型的时间数值
topicType：话题分类
说明统计当前版块下所有用户所发表主帖被回复的数量，按被回复数量排序，返回JSON格式（包括用户ID和被回复数）。
输出样例：[{"replycounttotal":9,"userid":826717},{"replycounttotal":2,"userid":388},{"replycounttotal":0,"userid":9659992},{"replycounttotal":0,"userid":149561},{"replycounttotal":0,"userid":9673315}]

/intf/user/queryUserReplyCount.do

参数
fid：版块ID
uid：用户ID
from：统计开始时间
to：统计结束时间
说明统计用户在某个版块，某个时间段回复数，返回JSON格式（需要登录后台，没有缓存）。
输出样例：{"count":1, "uid":903}

intf

_autosave.jsp 自动保存接口(可能仅供本应用调用,已不再使用)
_entry.jsp 本接口取消
_exscore-member.jsp 用于获得N天内的灌水或精华英雄榜

参数 type：类别(1,2,3,4,5,6分别表示为score1,score2,score3,score4,score5,score6)
count：多少条（默认10）
display：返回格式
说明返回js/JSON/ssi格式；接口缓存10小时
输出结果样例：[{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名}]

_forum.jsp 查询版块的主题帖

参数

fid=; 版块ID
count=10; 返回数量
display=table; 返回主题的页面格式，可选table或ul或json
pickStr=false; 是否查询版块精华帖

说明

返回的页面格式可以是table或ul或json

_forum_index_auto.jsp 生成汽车论坛"去其他版块"导航内容

此接口仅由应用内部调用

_forum-today-post.jsp 游戏网首页接口：id、贴数、板块名称、板块logo （重要）

参数
forumIds=1,2,3 板块id串
subf=anystring 是否需要包含子版
callback 回调函数名
说明
游戏网首页接口：id、贴数、板块名称、板块logo、描述、子版块的名字和url
输出结果样例:cb([{"count":0,"description":"","forumId":1,"forumName":"汽车网论坛","icon":"","subForums":[{"forumName":"一级版块","url":" http://dev_wan.pconline.com.cn/bbs7/forum-2.html"}, {"forumName":"一级兄弟版块","url":" http://dev_wan.pconline.com.cn/bbs7/forum-3.html"},{"forumName":"一级兄弟版块2","url":"http://dev_wan.pconline.com.cn/bbs7/forum-4.html"}]}]);

_forum-yesterday-post.jsp 得到某天的所有版块帖子的统计（重要）

参数
filename 8位,以年月日排,如20101001
说明
此方法是得到某天的所有版块帖子的统计,默认是昨天
输出版块的id、昨日发帖量、回帖量、PV总数
输出结果样例(非json)：1,5,5,100\r\n2,5,5,100\r\n

_hotForums.jsp 显示论坛板块发帖量排行榜（重要）
_hotForums2.jsp 显示论坛板块发帖量排行榜

参数 tag=hot_forums; 用于替换的标记名称
snum=10; 显示的数据条数
noForums=板块一id,板块二id,... 用于过滤不希望上本排行榜的板块，可以不配置。在后台设置隐藏的板块已经自动过滤掉了。
callback=; 回调函数名

_myPosts.jsp 生成嵌入外部页面的我的发帖列表

参数 memberId：用户id
tag：要用来显示内容的element id,这个参数为空则直接用document.write
target：是回帖（topics）还是主帖（replies），默认显示主帖。
maxSize：列出帖子最大数目,默认10条,不可以长于50条.
maxLength：帖子内容最大长度,默认240个英文字符,相当于120个汉字.
noCss：有这个参数代表不需要生成css.
说明本页面生成一段javascript，用于生成嵌入外部页面的我的发帖列表。调用方式是<script src="${ROOT}/_myPosts.jsp"></script>；接口缓存10小时

_onlineUser.jsp 根据版块ID，获取改版块下在线/登录用户数

参数

fid=; 要查询的版块ID

说明

返回数据类型为html块,缓存时间为900毫秒

_searchForum.jsp 论坛版块搜索接口

参数

q=;关键字
pageNo=1;
pageSize=20
callback=;回调函数名称

说明

返回数据类型为json,缓存时间为3600毫秒

_photos.jsp 获取指定帖子内的图片

参数

topicId=; 主题ID
postId=; 帖子ID
getPos=next/prev; 当没找到时按顺序还是倒序找下一个帖子
callback=; 回调函数名

说明

获取指定帖子内的图片,没找到时按参数继续找下一贴,以json格式返回

_pickForums.jsp 显示论坛板块本周精华帖排行榜参数

forums,noForums=; 要包含/排除的版块
topicType=; 帖子话题
type=f1/f2; 按1级或2级版块分组
display=; js/json/ssi
count=; 取前几位的版块

说明

查询版块一周精华数排行,没有区分pick和expick

_replies_count_json.jsp 获取主题回帖数

参数

tid=; 主题ID

说明

主题ID可以接受数组形式的参数，以json形式返回
输出样例：{"count":回帖数}

_score-member.jsp 获得N天内的灌水或精华英雄榜（重要）

参数 type：类别(pick为精华；water为灌水)
count：多少条（默认10）
days：统计多少天之内的（当天的不计）
display：返回格式
说明返回js/JSON/ssi格式；接口缓存10小时
输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}]

_score-member2.jsp 获得N天内的灌水或精华英雄榜

参数 type：类别(pick为精华；water为灌水)
count：多少条（默认10）
days：统计多少天之内的（当天的不计）
display：返回格式
说明返回JSON格式；没有接口缓存

_sumPosts.jsp 获取全站的帖子总数和主题总数

输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}]

参数 callback：回调函数
说明返回JSON格式，包括全站主题总数和全站帖子总数
输出样例：([{"posts":全站帖子总数,"topics":全站主题总数}]);

_tocensor.jsp 把tocensor表的数据发送到审核平台（重要）
_topic.jsp 根据主题ID，获取主题信息

参数

tid=; 要查询的主题ID
callback=; 回调函数名称

说明

返回数据类型为JSON

_topicReplies.jsp 论坛主题和其下回复页面

参数

tag=bbs_topicReplies; 用于替换的标记名称
count=10; 列出回复条数
topic=; 主题ID，不能为空
cl=150; 帖子内容显示字数
display=js; 可选js或json
callback=; 回调函数，仅返回类型为json时有效

说明

列出主题下的最新count条回帖，按楼层数逆序排列

_topics.jsp

参数

subsite=false;是否只查单个版块，默认为false
noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块
type=new;查询类型。可填new,hot,pick
display=ssi;显示方式，支持js,json和ssi
css=false; 是否使用CSS架构。true表示使用，这时会以DIV方式输出代码
count=10;列出条数
messageLength=;帖子内容最大长度,默认没有限制.（目前只有json时生效）
days=2;从多少天前的数据开始查询，可填任意整数
pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型
callback=;当display=json时使用的回调函数名称

说明

可以查看3种形式的主题列表，最新，最热，精华。根据subsite参数确定从哪个表查找。如果subsite=true，直接从bbs7_topic_xx表中读取数据。如果subsite=false，最新的主题从bbs7_new_topic里查找,最热的主题从bbs7_hot_topic,bbs7_hot_topic7,bbs7_hot_topic30,bbs7_hot_topic_all里查找，精华的主题从bbs7_pick里查找。

_topics_id.jsp

参数

ids=; 主题ID，多个主题ID用半角逗号分隔
count=10; 返回数量
display=; 默认显示主题所有相关信息。若display参数值不为空，则只返回参数值的信息，多个值用半角逗号分隔。例如：display=title,replyCount 则只返回主题的title和replyCount，其余不返回。
cl=250; 主题帖子内容的显示长度

说明

返回数据类型为JSON，可指定返回的字段
输出样例：([{"content":"帖子内容","createAt":"创建时间","forumId":版块ID,"forumName":"版块名称","forumUrl":版块URL","lastPostAt":"最后回复时间","pick":精华类型,"replyCount":回复数,"rewardAmount":悬赏金额,"rewardRemain":悬赏余额,"status":帖子状态,"title":"

标题 ","topicId":主题ID,"topicUrl":"主题URL","userId":用户ID,"userName":"用户名称","userUrl":"用户个人中心链接","viewCount":查看数,"isNew":是否新帖,"containImage":是否有图片,"isHot":是否热帖,"isPikc":是否精华帖}]);

_topics2.jsp 论坛主题列表javascript接口

参数

forum=;版块ID。查找的信息也会包含其子版块
type=new;查询类型。可填new,hot,pick
count=10;列出条数
pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型
callback=;回调函数名称

说明

可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找
输出样例：([{"createAt":"创建时间","forumId":版块ID,"forumName":"版块名称","forumUrl":"版块URL","lastPostAt":"最后回复时间","rate":查看数比例值,"rateReply":回复数比例值,"replyCount":回复数,"rewardAmount":悬赏金额,"rewardRemain":悬赏余额,"title":"

标题 ","topicId":主题ID,"topicUrl":"主题URL","userId":用户ID,"userName":"用户名称","userUrl":"用户个人中心链接","viewCount":查看数}]);

_topics-css.jsp 论坛主题列表javascript接口

参数

tag=bbs_topics; 用于替换的标记名称
forum=;版块ID。查找的信息也会包含其子版块
type=new;查询类型。可填new,hot,pick
display=js;显示方式，支持js,json和ssi
count=10;列出条数
callback=;当display=json时使用的回调函数名称

说明

可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找

_userExtTopics.jsp 论坛用户发扩展主题数接口

参数 uid：用户ID
extId：帖子的扩展ID(1:盖楼帖 2:为活动贴 3:交易帖 4:链接帖 5:一帖多发虚拟帖 6:达人牛帖)
dateFrom：开始日期
dateTo：结束日期
ck：回调函数
说明查询用户在一个时间段内的发扩展主题数，未包括已删除的；接口缓存10小时
输出样例说明：{"count":主题数}

_userTopics.jsp 论坛用户发主题数接口

参数 uid：用户ID
postCount：最少回帖数
dateFrom：开始日期
dateTo：结束日期
ck：回调函数
说明查询用户在一个时间段内的发扩展主题数和精华数，未包括已删除的；接口缓存10小时
输出样例说明：{"count":主题数, "picks":精华数}

_picksPeriod.jsp 获取一段时间内精华帖接口

参数 startdate：开始日期（需要传微秒形式）
enddate：结束日期（需要传微秒形式）
fid：板块ID
pick：1查精华 0查所有
topicType：话题类型(activity/vote/trade/html)
说明获取一段时间内精华帖；接口没有使用缓存

_friends.jsp

参数 uids：用户id,用半角逗号分隔
tag：要用来显示内容的element id,这个参数为空则直接用document.write
说明 (itbbs:似乎只是出一段用户信息的html,跟好友无关,不知道哪里用到)

_topicAndTops.jsp

参数 count：列出条数
forum: 版块id
pick：1表示只列精华,默认不限
reply：回复数至少有
days：只查最近多少天的
tag：用于替换的标记名称
top: 置顶帖条数
callback: 回调函数名
display: js/ssi/json
说明功能大致同intf/common/_topics.jsp,但是是出某一版块带置顶的帖子

prodTopic.jsp

与_topicAndTops.jsp一模一样

_forums.jsp

参数 of=1: 版块id showHidden=0: 是否显示隐藏版块 0以外显示 showRedirect=0: 是否显示有跳转链接的版块 0以外显示说明提供给软件下载，显示版块列表

action/user

active.jsp 论坛激活用户接口

（重要）参数

uid：用户ID
username：用户名
nickname：昵称
appCode：应用代码(暂时无用)

说明

调用机器IP需要在后台配置ScoreClientMachine范围内；如果根据用户ID找不到该用户，则新建一个用户，并激活。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

actived.jsp 论坛检查用户是否激活接口

（重要）参数

uid：用户ID数组（用户“,”分隔）

说明

调用机器IP需要在配置ScoreClientMachine范围内；传入用户ID数组，输出未激活的用户ID。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

admin_forums.jsp 论坛获取用户管理角色接口

参数

uid：用户ID

说明

用于在帖子页头衔上面显示。

check_favorite.jsp 论坛判断当前登录用户是否收藏了该帖子接口

（重要）参数

tid：主题ID
fid：板块ID

说明

如果是收藏了，则返回收藏ID，否则返回-1；如果tid参数不为空，则优先判断是否收藏了改帖子，如果tid为空，fid不为空，才判断是否收藏了该板块；需要用post方式提交

输出结果样例：0/1

contribution_update.jsp 论坛调用户贡献接口

参数

uid：用户ID
contribution：需要增加的贡献值
reason：原因

说明

需要用post方式提交，调整完之后会发送一条系统消息给用户。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

delete_posts.jsp 论坛清除用户发帖接口

参数

uid：用户ID
reason：原因

说明

必须使用post方式提交。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

exscore_update.jsp 论坛调用户扩展积分接口

参数

uid：用户ID
exscore：需要增加的积分值
reason：原因
type：扩展积分

说明

需要用post方式提交，调整完之后会发送一条系统消息给用户。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

favorite.jsp 论坛用户收藏接口

参数

fid：板块ID
tid：主题ID

说明

当前登录用户收藏包括板块或主题，收藏成功后会发动态到个人中心，必须使用post方式提交。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

favorite_delete.jsp 论坛删除当前登录用户收藏接口

参数

id：需要删除的收藏id

说明

支持批量删除，id用“,”分隔。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

favorite_forums.jsp 论坛获取当前登录用户收藏板块接口

参数

pageNo：第一页，默认第一页
pageSize：每页显示多少条，默认10条

说明

返回json数组格式。
输出结果样例：{"forumList":[{"favoriteId":收藏ID,"forumAdmins":[{"forumAdminId":版主用户ID,"forumAdminName":版主用户名}],"lastPostAt":最后发表时间,"lastPosterId":最后发表人 ID,"lastPosterNickname":最后发表人名,"name":板块ID,"postCount":回帖数,"todayPostCount":今天回帖数,"topicCount":发帖数,"url":板块链接}],"pageCount":总页数,"pageNo":页码,"pageSize":每页显示数据量,"total":总数据量}

favorite_topics.jsp 论坛获取当前登录用户收藏主题接口

参数

pageNo：第一页，默认第一页
pageSize：每页显示多少条，默认10条

说明

返回json数组格式。

输出结果样例：[{"author":用户名,"authorId":用户ID,"createAt":创建时间,"favoriteId":收藏ID,"lastPostAt":最后发表时间,"name":用户名,"replyCount":回复数,"url":主题链接,"views":查看数}]

lock.jsp 论坛锁用户接口

参数

fid：锁单个板块ID
uid：锁单个用户ID
fids：批量锁板块ID
uids：批量锁用户ID
reason：原因
expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）
type：如果是all，则锁全站，否则锁板块

说明

支持批量锁用户；非管理员角色，默认会发系统消息给用户；需要使用post方式提交。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明,"lockId":锁ID，"lockDesc":锁描述}]

lock_all.jsp 论坛锁用户接口

参数

uid：锁单个用户ID
reason：原因
expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）

说明

把单个用户锁全站；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

medal_update.jsp 论坛更新用户勋章接口

参数

uid：单个用户ID
reason：原因
medalId：勋章ID

说明

如果传入的勋章ID不在用户已有勋章范围内，则新增；如果用户已有的勋章ID不在传入勋章范围内，则删除该勋章。

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

propstr_update.jsp 论坛更新用户自定义头衔接口

参数

uid：用户ID
reason：原因
propstr：自定义头衔

说明

输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

recent_forums.jsp 论坛获取当前登录用户最近浏览板块接口

参数说明

根据cookie--"visitedfid"找到用户最近浏览的板块，返回json数组格式
输出结果样例：[{"url":板块链接,"name":版块名,"topicCount":主题数,"postCount":回帖数,"lastPosterId":最后发表人ID,"lastPosterNickname":最后发表人昵称,"lastPostAt":最后发表时间,"todayPostCount":今天回复数,"forumAdmins":{"forumAdminId"：版主ID,"forumAdminName":版主名称}}]

score_update.jsp 论坛调用户积分接口

参数

uid：用户ID
reason：原因
score：需要增加的积分值[BR]]

说明

需要用post方式提交，调整完之后会发送一条系统消息给用户
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

sign_disable.jsp 论坛屏蔽用户签名接口

参数

uid：用户ID
username：用户名
uids：多个用户ID[BR]] fid：板块ID（用于判断权限）
reason：原因

说明

支持批量处理用户签名；需要用post方式提交；屏蔽完之后会发送系统消息
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

sign_enable.jsp 论坛激活用户签名接口

参数

uid：用户ID
username：用户名
uids：多个用户ID[BR]] fid：板块ID（用于判断权限）
reason：原因

说明

支持批量处理用户签名；需要用post方式提交；激活完之后会发送系统消息
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

unlock.jsp 论坛用户解锁接口

参数

lockId：锁ID
reason：原因

说明

根据锁ID解锁用户；解锁完之后完之后会发送系统消息
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

unlock_all.jsp 论坛用户解锁（全站）接口

参数

uid：用户ID
reason：原因

说明

把单个用户全站解锁；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

unlockByUserId.jsp 论坛用户解锁接口

参数

uids：用户ID
reason：原因

说明

按用户id对用户全站被锁的模块都解锁；支持批量方式；需要post方式提交；解锁完之后完之后会发送系统消息
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

update.jsp 论坛修改用户信息接口

参数

nickname：昵称
sign：个性签名
hintMessage：是否暗示消息(?)
propNum：用户所在城市ID
propStr：扩展字段

说明

修改当前登录用户个性签名（自动激活）、扩展字段（如果是汽车网则包括地区ID）、昵称、hintMessage；需要用post方式提交
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

update_contact.jsp 论坛修改用户联系方式接口

参数

uid：用户ID
contact：联系方式
reason：原因

说明

家居网专有(以后可以废弃，改用controller方式)

updateProp.jsp 论坛修改用户信息接口

参数

propNum：用户所在城市ID
propStr：拥有车型ID;车型名,如没有车型的填写车系ID;车系名
type: 为0时,更新两个,当为1时,更新propStr,当为2时,更新propNum

说明

修改当用户扩展字段（如果是汽车网则包括地区ID）；需要用post方式提交
输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}]

user_json.jsp 论坛获取单个用户信息接口

参数

id：用户ID
name：账号
callback: 回调函数

说明

返回json,信息包括用户ID、账号、昵称、注册时间、积分、所在角色组名
输出结果样例：{"createAt":创建时间,"groupName":会员组名,"name":用户名,"nickname":昵称,"score":积分,"userId":用户ID}

user_setting_json.jsp 论坛获取单个用户信息接口

参数

uid：用户ID
name：账号
callback: 回调函数

说明

包括用户所有信息，如果不是审核员，还会返回用户管理角色列表。
输出结果样例：{"adminRoles":[],"allowUseUbb":是否允许使用ubb,"contribution":贡献,"createAt":注册时间,"exScore1":扩展积分1,"exScore2":扩展积分2,"exScore3":扩展积分3,"exScore4":扩展积分4,"exScore5":扩展积分5,"hintMessage":是否使用暗示消息,"level":等级,"medals":[勋章],"name":用户名,"next":下一级下限的分数,"nickname":你曾,"pickCount":精华数,"postCount":回帖数,"propStr":扩展字段1,"rank":会员组名,"rankLevel":{"star":1,"moon":1,"sun":1},"score":积分,"sign":签名,"signStatus":签名状态,"topicCount":主题数,"totalLevel":总会员组数,"userId":用户ID,"viewSign":是否显示签名}

rest

forums.jsp 论坛列表页和发主题接口（重要）

参数

forumId：板块ID
title：主题标题
type：主题类型
message：内容
pageNo：第几页
pageSize：每页显示多少条

说明

POST:发帖;GET:列表页
注:销售配合开始： 2012-11-28至2012-12-04、2012-12-13至2012-12-20 在forum16655版块置顶帖子3431731。

topics.jsp 论坛帖子页和发回帖接口（重要）

参数

topicId：主题ID
title：主题标题
reason：删帖原因
message：内容
pageNo：第几页
pageSize：每页显示多少条
desc：是否按照楼层降序排序，如果不传该参数，则按升序排
_method：DELETE和PUT方式需要传该参数（POST方式提交）

说明

POST:回帖;GET:帖子页;DELETE:删主题;PUT:更新主题。

返回说明

DELETE:没有返回内容[[BR]] PUT:Location:帖子链接[[BR]] POST:Location:帖子链接[[BR]] GET{"pageNo":第几页,"pageSize":每页显示条数,"postList":[{"author":{"name":"用户名","nickname":呢称,"userId":用户ID},"createAt":创建时间,"floor":楼层,"message":内容,"postId":回帖ID,"status":状态}]}

topics-posts.jsp 论坛回帖修改和删除接口（重要）

参数

topicId：主题ID
postId：回帖ID
reason：删帖原因
message：内容

说明

DELETE:删帖;PUT:更新。

返回说明

没有返回内容

topics-hot.jsp 论坛热榜接口

参数

range：范围，"week"表示查一周热帖排行；"month"表示查一个月热帖排行；不传则查一天热帖排行
count：获取多少条数据

说明

返回JSON数组格式。

topline/tree.jsp 论坛获取直接子版块信息接口

参数

root：板块ID
callback：回调函数

说明

util

119.jsp
功能

动态修改spring容器中bean的属性
参数 bean : spring bean id属性

adminrole.jsp
功能

根据用户ID或版块ID来查找管理员角色

ai_findpxurl.jsp
功能

通过topicId查看pickax的url

ai_topic_post.jsp
功能

根据topicId来查看主题状态和该主题下的post状态

ai_topic_type_change.jsp
功能

修改主题的话题类型

censor.jsp
功能

此接口接收的是信息队列发送过来审核平台的信息
不再使用,功能转移到controller

d_topic.jsp
功能

此页面用于过滤要删除的主题

d.jsp 功能

此页面用于过滤要删除的帖子

file.jsp 功能此接口供各个服务器上的定时任务，获取计数器数据文件
参数如下：

method : ls(列出文件名)

path : 0 | 15

return：如果在path目录下存在数据文件，则打印文件名

或

method : get(获取计数器数据文件)|rm(删除服务器上的计数器数据文件)

path : 0 | 15

filename: 数据文件，如200811301200

return：如果在path目录下存在数据文件，则打印文件内容

或

method : rm(删除服务器上的计数器数据文件)

path : 0 | 15

filename: 数据文件，如200811301200

return：void

import_photo_post.jsp 功能

图片分离补录功能,如果某个帖子的图片信息未保存到post_photo表中，可以用该接口来补录
参数

topicId : 主题id,type:topic
或
postId : 帖子id,type:post

ks_autobbs.jsp 功能

从汽车网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子

ks_babybbs.jsp 功能

从亲子网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子

ks_bbs.jsp
功能

从电脑网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子

ks_gamesbbs.jsp
功能

从游戏网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子

ks_ladybbs.jsp
功能

从女性网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子

logsetting.jsp 功能

设置EnvFilter的log level（开发人员调试用）

mc.jsp 功能

查看或清除mc缓存
参数

action: delete|update|view(默认值)

key: mc缓存key

monitor.jsp 功能

查看应用运行效率的利器

monitor2.jsp 功能

查看应用运行效率的利器

move_forum_topics.jsp 功能

将某个版块的主题移动到指定目标版块

online.jsp 功能

获取在线用户的uid列表
参数 cb: 回调函数
ids: 用户id列表，用逗号分隔

返回

在线用户数组

poster.jsp （重要）功能

灌水机接口

参数

uid 用户ID
method 有2种方式，发帖与发主题，reply为发帖，默认为发主题
content 帖子内容
tid 主题ID
fid 版块ID
type 主题类别,String 不验证是否当前版块存在,但最好是存在的,否则没法通过类别过滤
title 标题

发表回帖需要uid,method=reply,content,tid
发表主题需要uid,content,fid,type,title
uid,tid,fid用find方法,如论坛没有,则抛出错误

返回

json数据,status=0时，发帖成功

px.jsp

功能

向快聚接口发送主题
参数
tid:主题id

sync.jsp 功能

清除各种常驻内存配置对象的jsp，需要从服务器端发出请求才行
合法服务器的列表在appname = System, appkey = servers应用配置项中

test_ip.jsp

功能本jsp用于测试调用方的服务器ip

text.jsp

功能根据logid查询回帖内容

参数 logid: post备份日志id

date: post_text_history_分表后缀

返回

回帖内容

untop_deleted_top.jsp

功能

取消所有全站置项

upload.jsp 功能用flash上传图片

user_score.jsp 功能

查看用户积分，贡献等信息

参数

callback:回调函数(必须)[[BR]]

ids:用户id列表，用逗号分隔(必须)[[BR]]

返回 json格式数组

ck([{'userId':388,'score':194,'contribution':57,'level':4,'totalLevel':19,'title':'太平洋舰队上等兵','next':200}]);

visited_forum_list.jsp 功能列举指定的版块的信息参数 type : 返回的数据的格式(html|json)

fids : 版块id列表，用'D'分隔

返回

json格式数组

[{"forumId":4,"name":"一级兄弟版块2","url":" http://localhost.pcauto.com.cn/bbs7/forum-4.html"}]

/util/roleright.do
功能
查看roleright内存

/util/userforumrole.do
功能
查看userforumrole内存

/util/lock.do
功能
查看锁用户，锁IP内存

do

/intf/forum/picks.do
功能
查询版块精华接口（查询bbs7_pick表），接口缓存6小时
参数
fid：板块ID
count：获取条数（默认5条）
days：多少天内发的帖子（默认2天）
orderby：排序条件（默认排序字段是createAt）
needContainImage：是否必须包含图片
maxLength:帖子内容最大长度
callback:回调函数
返回
json格式数组
cb([{"forumId":板块ID,"fourmUrl":板块地址,"topicId":主题ID,"topicUrl":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"viewCount":查看数,"authorName":作者昵称,"authorUrl":作者个人中心地址,"cover":封面,"title":标题}])

user/getScore.do 获取论坛用户积分接口

参数

uid：用户ID
date：时间格式为yyyy-MM
输出结果：返回json格式(包含createat创建时间，amount积分数量，slot积分类型，reason评分原因，createbyid评分的用户id)

user/updateNickName.do 从消息队列中接收各网修改昵称的消息

参数 msg:格式为{"appName":"common","actionType":"updateNickName","msg":{"accountId":388,"nickName":"fishOK2"}}[[BR]] 输出结果：返回json格式

/intf/forum/pickYesterday.do
功能
查询版块精华接口（查询bbs7_pick表,以前一天的回复数排序），接口缓存24小时
参数
fids：板块ID(多个以逗号分隔)
count：获取条数（默认5条）
maxLength:帖子内容最大长度
callback:回调函数
返回
json格式数组
cb([{"forumId":板块ID,"fourmUrl":板块地址,"topicId":主题ID,"topicUrl":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"viewCount":查看数,"authorName":作者昵称,"authorUrl":作者个人中心地址}])

/intf/topics.do 根据tid，获取主题基本信息,支持批量，中间用逗号分隔

参数 tids:帖子ID[[BR]] callback:回调函数
输出结果：返回json格式

cb([{"fid":板块ID,"uid":作者id,"tid":主题ID,"uri":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"view":查看数,"userName":作者名称,"nickName":作者昵称,"floor":总楼层，"containImage":是否包含图片,"censor":审核状态}])

/intf/forums.do 根据fid，获取版块基本信息，支持批量，中间用逗号分隔

参数 fids:帖子ID[[BR]] callback:回调函数
输出结果：返回json格式
cb([{"fid":板块id,"forumName":板块名称,"title":标题,"forumUrl":链接,"forumIcon":图片,"forumDesc":板块介绍,"forumKeyword":关键词,"forumAdmin1":{"uid":版主id,"name":姓名,"nickname":昵称,"userUrl":链接},"forumAdmin5":{"uid":版副id,"name":姓名,"nickname":昵称,"userUrl":链接},"forumAdmin1":{"uid":嘉宾id,"name":姓名,"nickname":昵称,"userUrl":链接},}})

/intf/user/query/myPost.do 查询用户的帖子

参数 uid:帖子ID[[BR]] type:类型（默认为topic）
pageNo:当前页
pageSize:每页数量
输出结果：返回页面intf/myPost.jsp

/intf/user/query/favorite.do 去查询用户的收藏的帖子及发的帖子

参数 uid:帖子ID[[BR]] type:类型（默认为topic）
pageNo:当前页
pageSize:每页数量
输出结果：返回页面intf/userFavorite.jsp

/intf/user/memcp.do 去查询用户个人资料、签名

参数用户登录后即可。输出结果：返回页面intf/memcp.jsp

/mobile/topics.do 去查询论坛主题列表

参数 help:接口帮助（为true时返回接口具体使用介绍）[[BR]] 输出结果：返回页面intf/memcp.jsp

mobile

4.1生活圈精华帖子列表

  备注：生活圈帖子列表,时间倒序
  请求URL：http://bbs.pcbaby.com.cn/intf/forum/getPicks.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：有
  缓存时间：1小时
  请求参数：
  forums=1;需要查询的版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块
  noForums=0;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
  pickType=pickA;精华类型，可填all,pickA,pickB,pick1,pick2,pick3,pick4,pick5;其中pickA和pickB查的都是普通精华，all为查询所有精华
  pageNo:当前第几页
  pageSize:每页显示的数量，默认为10条
  maxLength:帖子内容需要截取的长度，默认240个字节
  callback:回调函数
  ie=gbk;输出内容的编码格式
  cacheTime=3600;缓存时间，单位为秒
  返回参数：
  {
   status: 0
   desc: "查询成功"
   topics:[
    {
       forumId: 版块id
       forumName: 版块名称
       topicId: 帖子id
       title: 帖子标题
       message: 帖子内容需要截取的长度，默认240个字节
       authorName: 帖子的用户名
       createAt: 帖子的创建时间
       views: 帖子浏览数
       replyCount: 帖子回复数
    }
   ]
  }

4.1.1生活圈最新帖子列表

  备注：生活圈最新帖子列表,时间倒序
  请求URL：http://bbs.pcbaby.com.cn/mobile/getNewTopics.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：1小时
  请求参数：
  fids：指定版块id,多个id用逗号隔开（如：fids=1776,1948,1799,1915）
  pageNo:
  pageSize:
  ie:产出内容的编码，默认为gbk
  maxLength:帖子内容需要截取的长度，默认240个字节
  noFids:需要过滤的版块id，多个id用逗号隔开（如：noFids=1776,1948,1799,1915）注意：该参数只有在fid=1的时候才有效
  
  返回参数,成功：
{
   fids: "1771,1776",
   topics:[
  {
      category: "婆媳",
      categoryId: 2,
      createAt: "2014-06-18 14:51:38",
      floor: 1,
      forumId: 1771,
      forumName: "女人心情",
      forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-1771.html",
      images: [
        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205470_1402557443988_1024x1024.jpeg",
        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205471_1402557448357_1024x1024.jpg",
        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205479_1402559413897_1024x1024.png"
      ],
      lastPostAt: "2014-06-18 14:51:38",
      message: "修改分类修改分类",
      replyCount: 0,
      rewardAmount: 0,
      rewardRemain: 0,
      title: "婆媳",
      topicId: 1942176,
      topicUrl: "http://localhost.pconline.com.cn/bbs7/topic-1942176.html",
      userId: 826717,
      userName: "MyNameIsSoLongAndBig",
      userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/",
      viewCount: 1
    }
   ]
  }

4.5回帖、发帖

  备注:回帖、发帖
  请求URL：http://bbs.pcbaby.com.cn/rest/forums.jsp
  HTTP请求方式：post
  是否需要登录：是
  返回格式：JSON
  缓存方式：无
  缓存时间：无
  请求参数：
   agent：1待验证
   message = 内容;
   replyToId = 回帖楼层id
   category:性福，婆媳，情感，职场，姐妹，邻里---分类
   anonymous 代表是否匿名， 1为匿名，0为正常
   设置header  Cookie = "common_session_id=xxxx";
  返回参数
  {
   msg:
   result:
  }

4.7私密圈帖子列表-私语

  备注:私密圈帖子,时间倒序
  请求URL：http://bbs.pcbaby.com.cn/mobile/getSecretTopics.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：1小时
  请求参数：
  type:1私语（默认），2话题
  pageNo:
  pageSize:
  ie:产出内容的编码，默认为gbk
  maxLength:帖子内容需要截取的长度，默认240个字节
  
  返回参数,成功：
  {
  fids: "2250",
  topics: [
    {
      category: "性福",
      categoryId: 1,
      createAt: "2014-06-13 11:50:22",
      floor: 11,
      forumId: 2250,
      forumName: "匿名板块",
      forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-2250.html",
      lastPostAt: "2014-06-20 14:55:32",
      message: "处女贴处女贴处女贴",
      replyCount: 10,
      rewardAmount: 0,
      rewardRemain: 0,
      title: "处女贴",
      topicId: 1942125,
      topicUrl: "javascript:void(0)",
      userId: 826717,
      userName: "M***",
      userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/",
      viewCount: 1
    }
  ]
}

4.7私密圈帖子列表-话题

  备注:私密圈帖子,时间倒序
  请求URL：http://bbs.pcbaby.com.cn/mobile/getSecretTopics.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：1小时
  请求参数：
  type:1私语（默认），2话题
  pageNo:
  pageSize:
  ie:产出内容的编码，默认为gbk
  maxLength:帖子内容需要截取的长度，默认240个字节
  
  返回参数,成功：
  {
  fids: "2250",
  topics: [
    {
      category: "性福",
      categoryId: 1,
      createAt: "2014-06-13 11:50:22",
      floor: 11,
      forumId: 2250,
      forumName: "匿名板块",
      forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-2250.html",
      lastPostAt: "2014-06-20 14:55:32",
      message: "处女贴处女贴处女贴",
      replyCount: 10,
      rewardAmount: 0,
      rewardRemain: 0,
      title: "处女贴",
      topicId: 1942125,
      topicUrl: "javascript:void(0)",
      userId: 826717,
      userName: "M***",
      userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/",
      viewCount: 1
    }
  ]
}

4.8私密圈闺蜜帖子列表

  备注:私密圈闺蜜帖子，时间倒序
  请求URL：http://bbs.pcbaby.com.cn/mobile/getBestieTopics.do
  HTTP请求方式：get
  是否需要登录：否
  返回格式：JSON
  缓存方式：无
  缓存时间：无
  请求参数：
  返回参数
  {
   id:
   name:
   topics:[
    {
       pid:改回复的id
       topicId:原帖子的id
       title:标题
       message:内容简介，截取正文部分内容
       viewsNum:浏览数
       commentNum:楼层数
       categoryId:1性福，2婆媳，3情感，4职场，5姐妹，6邻里
       category:对应category的名字
       replyContent:回复内容
       replyAuthorName:回帖用户名
       replyAuthorId:回帖用户id
       replyTime:回复时间戳
       topicAuthorId: 主贴用户id
    }
   ]
  }

6.2我的交流圈-主帖、精华帖、回帖

 备注:我的交流圈-主帖、精华帖、回帖
 请求URL：http://bbs.pcbaby.com.cn/intf/user/queryUserPost.do
 HTTP请求方式：get
 是否需要登录：否
 返回格式：JSON
 缓存方式：无
 缓存时间：无
 请求参数：
  uid: 用户id，默认为当前登录用户id
  type: 查询类型，默认为topic；可填topic（主贴），pick（精华帖），reply（回帖）
  pageNo: 当前第几页
  pageSize: 每页显示的数量，默认10条
  maxLength: 帖子内容需要截取的长度，默认240个字节
  callback: 回调函数
  ie=gbk;输出内容的编码格式
 type为topic或pick时的返回参数，成功时：
 {
   status: 0,
   desc: "查询成功",
   uid: 用户id,
   topics:[
    {
       topicId: 主帖id,
       title: 标题,
       message: 截取的帖子内容,
       authorName: 主帖的用户名,
       createAt: 发帖时间,
       views: 帖子浏览数,
       replyCount: 帖子回复数
    }
   ]
 }
 失败时：
 {
    desc: "原因描述",
    status: 状态码
 }

 type为reply时的返回参数，成功时：
  {
   status: 0,
   desc: "查询成功",
   uid: 用户id,
   topics:[
    {
       topicId: 主帖id,
       image: 主帖中的第一张图片,
       title: 主帖标题,
       message: 截取的帖子内容,
       authorName: 主帖的用户名,
       createAt: 主帖创建时间,
       views: 主帖浏览数,
       replyCount: 主帖回复数,
       categoryId: 1性福，2婆媳，3情感，4职场，5姐妹，6邻里,
       category: 对应category的名字,
       replyContent: 回帖的内容,
       replyAuthorName: 回帖的用户名,
       replyAuthorId: 回帖的用户id,
       replyTime: 回帖的时间
    }
   ]
  }
  失败时：
  {
     desc: "原因描述",
     status: 状态码
  }

6.3我的交流圈数量

 备注:我的交流圈-主贴、精华帖
 请求URL：http://bbs.pcbaby.com.cn/intf/user/queryUserPostCount.do
 HTTP请求方式：get
 是否需要登录：否
 返回格式：JSON
 缓存方式：无
 缓存时间：无
 请求参数：
 uid: 用户id，默认查询当前登录用户id
 返回参数
  {
  topicCount:主帖数量
  pickCount:精华帖数量
  replyCount:回帖数量
  }

Download in other formats:

Plain Text