= 接口列表 = == 字段说明( == 如有字段不清楚，请查看以下字段说明 == ) == // 参数说明 // // 公共参数 // callback:回调函数 [[BR]] windowname: [[BR]] maxLength帖子摘要的最大字符 [[BR]] help:接口帮助 [[BR]] pageSize:每页显示的条数 [[BR]] pageNo:当前页数 [[BR]] showImage:是否显示图片 [[BR]] showImageCount:显示图片的数量 [[BR]] cacheTime:接口内容缓存时间，以秒为单位 [[BR]] ie:产出内容的字符编码 [[BR]] // 其他参数 // [[BR]] pickType:精华类型 [[BR]] count返回的数据条数[[BR]] fids/forums(废弃):版块ID(多个以，分隔) fids=1则查全站[[BR]] noFids/noForums(废弃):过滤的版块ID(多个以，分隔)[[BR]] // 返回字段说明 // authorName-用户名 [[BR]] authorUrl-用户url [[BR]] createAt-帖子创建时间 [[BR]] forumId-帖子所在的板块id [[BR]] total-返回数据的总数 [[BR]] pageSize:每页显示的条数 [[BR]] pageNo:当前页数 [[BR]] forumUrl-板块url [[BR]] lastPostAt-帖子最后回复的时间 [[BR]] message-帖子内容摘要 [[BR]] replyCount-回复数 [[BR]] title-帖子标题 [[BR]] topicId-帖子id [[BR]] topicUrl-帖子url [[BR]] uid-用户id [[BR]] userFaceUrl-用户头像url [[BR]] viewCount-帖子查看数[[BR]][[BR]] == 目录 == * [#p_intf_common intf/common] * [#p_intf_special intf/special] * [#p_intf_user intf/user] * [#p_intf intf] * [#p_action_user action/user] * [#p_rest rest] * [#p_util util] * [#p_do do] * [#p_mobile mobile] == [=#p_intf_common]intf/common == * _topics.jsp 论坛主题列表接口(重要)[[BR]][[BR]] //参数// subsite=false;是否只查单个版块，默认为false。[[BR]] 当subsite=false时，支持以下参数：[[BR]] noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块[[BR]] forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。[[BR]] 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(全部精华帖)[[BR]] pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] orderby=;查询类型为hot时，默认按回复数(replyCount)排序，要按点击数(view)排序就需要加此配置。查询类型为pick时，默认按发帖时间(createAt)排序，要按点击数(view)排序就需要加此配置。[[BR]] 当subsite=true时，支持以下参数：[[BR]] forums=;只能接受一个版块ID，多个版块取第一个[[BR]] top=3;置顶帖条数[[BR]] days=2;从多少天前的数据开始查询，可填任意整数[[BR]] type=new;可填new,hot,pick,top[[BR]] extId=;6为达人牛帖(暂未实现)[[BR]] reply=-1;回复数大于等于多少，为-1时没有限制[[BR]] replyMax=-1;回复数最大是少于多少，为-1时没有限制[[BR]] topicType=;话题类别，默认为不填[[BR]] topicTypeUTF8=;话题类别UTF8格式处理，默认为不填[[BR]] count=10;列出条数[[BR]] display=json;显示方式，支持json和ssi[[BR]] maxLength=240;帖子内容最大长度,默认240个英文字符,相当于120个汉字.（目前只有json时生效）[[BR]] faceWidth:需要返回头像时设定头像的宽度 [[BR]] callback=;当display=json时使用的回调函数名称 [[BR]] //说明// 可以查看4种形式的主题列表，最新，顶置，最热，精华。根据subsite参数确定从哪个表查找[[BR]] 如果subsite=true，直接从bbs7_topic_xx表中读取数据[[BR]] 如果subsite=false，最新的主题从bbs7_new_topic里查找,最热的主题从bbs7_hot_topic,bbs7_hot_topic7,bbs7_hot_topic30,bbs7_hot_topic_all里查找，精华的主题从bbs7_pick里查找。[[BR]][[BR]] 输出内容包括：forumId，forumName，forumUrl，userId，userName，userUrl，topicId，title，message，rewardAmount，rewardRemain，replyCount，viewCount，createAt，lastPostAt，topicUrl，rate，rateReply，type。如果type=new，则还需要返回face，dealedTime[[BR]][[BR]] * _topic.jsp 根据主题ID，获取主题信息[[BR]][[BR]] //参数// tid=; 要查询的主题ID[[BR]] callback=; 回调函数名称 [[BR]] //说明// 返回数据类型为JSON [[BR]] 输出格式样例：{"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":查看数}[[BR]] * _users.jsp 获取用户数据 //参数// pageType：为user时，返回发帖数排行用户JSON(需要传type参数);为lastpost时，返回最后发帖的用户JSON，否则返回用户的基本信息(需要传userIds)[[BR]] days：多少天内的数据(针对typeType=user，默认1天，当天不计)[[BR]] pageSize：返回结果数（默认50）[[BR]] userIds：用户ID[[BR]] faceWidth：用户头像宽度(type=pick时需要传)[[BR]] type：“week”为本周贴数，“pick”为全部精华帖,需要返回头像(默认是查精华)[[BR]] callback：回调函数[[BR]] //说明// 返货json数据格式，包括用户ID、用户名、昵称、用户个人中心url地址、头像宽度、发主题数、回帖数；接口缓存10小时[[BR]] 数据格式样例(pageType=user)：[{"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}, {"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}][[BR]][[BR]] * _topicRepliesJson.jsp 根据主题ID，按顺序分页显示回帖(重要）[[BR]][[BR]] //参数// tid=; 要查询的主题ID[[BR]] len=200; 内容显示的字数，过滤掉UBB，默认200字符，如果负数则表示不截取，显示完整的(显示完整内容时会把ubb转换成html)[[BR]] pageNo=1; 页数 [[BR]] pageSize=10; 每页显示数量 [[BR]] callback=; 回调函数名称 [[BR]] //说明// 返回数据类型为JSON[[BR]] 输出格式样例：({"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":查看数});[[BR]] * _forumNames.jsp 取版块名称 * _contributionUsers.jsp 论坛获取全站用户贡献值排行榜接口 //参数// aa：显示数据的个数，默认值是10[[BR]] type：输出地格式默认是ssi,还有json可选[[BR]] callback：回调函数[[BR]] //说明// 输出结果包括用户ID、用户名、昵称、用户个人中心url地址；用json输出；接口缓存10小时[[BR]] 输出格式样例：[{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名},{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名}][[BR]][[BR]] * _block_forums.jsp 给果派论坛首页使用（重要） //参数// fids：版块id以,逗号组成[[BR]] callback：回调函数[[BR]] //说明// 根据fids，检索各个板块的今天发帖量、主题总数、回帖总数及最后一个主题的详细，输出格式样例：[{"forumId":1,"count":1,"topics":1,"posts":1},"lastTopicAuthor"{"lastTopicId":1,"lastTopicTitle":1,"lastTopicUrl":1}][[BR]] * _forumTopics.jsp(it) （重要） //参数// fid：版块id[[BR]] pageNo：页号[[BR]] pageSize：分页大小[[BR]] callback：回调函数[[BR]] //说明// 根据fid，按发帖时间倒序分页显示Topic，用JSON输出，有分页[[BR]] * _postCountByHotForums.jsp(it) //说明// 本接口用于显示论坛板块发帖量排行榜，显示昨天的发帖量排行 功能同_hotForums.jsp,去掉了js显示 * _postsByUser.jsp(it) //参数// uid：用户id[[BR]] type=topic：reply/topic[[BR]] count=10：显示条数[[BR]] maxLength=240：内容最大长度[[BR]] //说明// 将_myPosts.jsp和_user-posts.jsp整合成该页面，并将返回格式统一为json[[BR]] * _todayPostCountByForum.jsp(it) （重要） //参数// fids: 多个fid用逗号分隔[[BR]] //说明// 同_forum-today-post.jsp * _top_user.jsp(it) //参数// type: pick/water/topic/post/contribution days: 统计多少天之内的 count=10: 显示条数 display=json: json/ssi callback: 回调函数[[BR]] //说明// 本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。 * _topicReplies.jsp(it) （重要） //参数// tag: 用于替换的页面元素id tid: 主题id,非空 count=10: 显示条数 cl=150: 帖子内容显示字数[[BR]] //说明// 论坛主题和其下回复页面接口 * _topicRepliesList.jsp(it)（重要） //参数// tid: 主题id,非空 callback: 回调函数[[BR]] //说明// 返回给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: 回调函数[[BR]] //说明// 根据主题ID查找主题回帖数 返回例:cb({"count":1} ); * _userList.jsp(it) //参数// type: pick/water/topic/post/contribution days: 统计多少天之内的 count=10: 显示条数 display=json: json/ssi callback: 回调函数[[BR]] //说明// 本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。 同_score-member.jsp == [=#p_intf_special]intf/special == * _active_user.jsp 得到论坛的活跃好友ID //参数// size：从数据库里拿出的活跃好友个数[[BR]] returnsize：返回的个数[[BR]] callback：回调函数[[BR]] //说明// 先从bbs7_user 按lastpostat排序(7天内)，取前size个,最后随机返回returnsize个用户的ID；接口缓存10小时[[BR]] 输出格式样例：{}[[BR]][[BR]] * _searchHTML.jsp 通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]][[BR]] //参数// searchWord=; 关键字[[BR]] pageNo=1; 页数[[BR]] pageSize=1; 每页显示数量[[BR]] searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容[[BR]] //说明// 如果从快速得到的结果为空，则返回最新的一条精华数据[[BR]][[BR]] * _topics_activity.jsp 现在用于摄影部落chinajoy活动 //参数// fid=; 版块id[[BR]] startDate=1; 活动开始时间yyyyMMdd[[BR]] containimage=1; 是否只出包含图片的[[BR]] type=1; 没用到[[BR]] isFilter=; 是否过滤关键字[[BR]] titleFilter=; 标题过滤字,需要设置isFilter=1才生效[[BR]] orderby=createTime; 排序[[BR]] lineSize=3; 一行显示数[[BR]] pageNo=1; 页号[[BR]] pageSize=9; 每页显示数[[BR]] imgWidth=; 图片宽度[[BR]] imgHeight=; 图片高度[[BR]] css=; 引用样式表路径,有默认[[BR]] display=js/json; 显示方式,默认为js[[BR]] callback=; 回调函数[[BR]] //说明// 读论坛图片接口修改技术需求[[BR]][[BR]] * _autoForumAdmin.jsp 论坛根据车系id返回对应版块下的版主、版副、嘉宾接口 //参数// sids：车系ID，多个ID半角逗号分隔(需要在后台板块车系对应插件配置中配置对应关系)[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；接口缓存10小时[[BR]] 输出格式样例：{"forumAdmin1"（版主）:[{"userId":用户ID,"name":用户名,"nickName":昵称}],"forumAdmin2"（版副）:[],"forumAdmin3"（嘉宾）:[],"forumId":板块ID,"sid":车系ID}[[BR]][[BR]] * _baby_120827.jsp 亲子网论坛获取用户回帖接口 //参数// uid=25315560l：用户ID[[BR]] tid=1191267l：主题ID[[BR]] maxlength：内容显示最大长度[[BR]] callback：回调函数[[BR]] //说明// 考虑性能关系 只在该用户的最新50条回帖里找 如果该用户最新50条回帖都不是该贴内的则不会返回结果；接口缓存720小时[[BR]][[BR]] * _showCar_cache.jsp vip插件接口的缓存接口 //说明// bbs7已不需要此接口[[BR]][[BR]] == [=#p_intf_user]intf/user == * _topics.jsp 我的主题 （重要） //参数// userId：用户ID[[BR]] pageSize：每页显示多少条（默认50）[[BR]] pageNo：第几页[[BR]] maxLength：帖子内容显示最大长度[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；结果会过滤已删除;接口缓存10小时[[BR]] 输出结果样例：{"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[[BR]] pageSize：每页显示多少条（默认50）[[BR]] pageNo：第几页[[BR]] maxLength: 回复内容显示最大长度[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；结果会过滤已删除及未审核;接口缓存10小时[[BR]] 输出结果样例：{"list":[{"topicId":主题id,"title":主题标题,"topicUrl":主题URL,"url":回复本楼URL,"floor":所处楼层,"content":回复内容,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}[[BR]][[BR]] * _picks.jsp 我的精华帖 （重要） //参数// userId：用户ID[[BR]] pageSize：每页显示多少条（默认50）[[BR]] pageNo：第几页[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；结果会过滤已删除;接口缓存10小时[[BR]] 输出结果样例：{"list":[{"title":主题标题,"url":主题url,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}[[BR]][[BR]] * _favForums.jsp 我收藏的版块 （重要） //参数// userId：用户ID[[BR]] pageSize：每页显示多少条（默认50）[[BR]] pageNo：第几页[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；没有接口缓存;如果userId不传，则查找当前登录用户的收藏板块[[BR]] 输出结果样例：{"list":[{"favoriteId":收藏ID,"forumId":板块ID,"name":板块名称,"url":板块地址}],"listCount":记录数}[[BR]][[BR]] * _favTopics.jsp 我收藏的帖子 （重要） //参数// userId：用户ID[[BR]] pageSize：每页显示多少条（默认50）[[BR]] pageNo：第几页[[BR]] callback：回调函数[[BR]] //说明// 返回json格式；没有接口缓存[[BR]] 输出结果样例：{"list":[{"favoriteId":收藏ID,"forumName":板块名称,"forumUrl":板块链接,"isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":最后发表时间,"replyCount":回复数,"title":标题,"topicId":主题ID,"url":主题链接,"viewCount":查看数}],"listCount":记录数}[[BR]][[BR]] * _idTopics.jsp 根据ID获取主题对象列表[[BR]][[BR]] //参数// ids=; 要查询的主题ID，多个主题ID用半角逗号分隔[[BR]] callback=; 回调函数[[BR]] //说明// 返回数据类型为JSON[[BR]][[BR]] 输出结果样例：{"list":[{"authorName":"作者名称","authorNickName":"作者昵称","authorUrl":"作者个人中心链接","createAt":"创建时间","forumName":"版块名称","forumUrl":"版块URL","isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":"最后回复时间","replyCount":回复数,"title":"标题","topicId":主题ID,"url":"主题URL","viewCount":查看数}],"listCount":列表大小}[[BR]][[BR]] * _extIds.jsp[[BR]][[BR]] //参数// userId=;要查询的用户id[[BR]] extId=;bbs6中的extId种类,1~6,需要导完旧数据才可查[[BR]] dateTrom,dateTo=;yyyy-MM-dd格式日期[[BR]] pageNo,pageSize=;分页参数[[BR]] callback=;回调函数名[[BR]] //说明// 用于查询兼容bbs6里用户的扩展贴,json格式 * _setVip.jsp //参数// uid：用户ID[[BR]] action：操作(checkVip:检查车主认证状态) [[BR]] status：状态(1：通过认证；-1：被驳回；2：提交申请成功；-2：被取消资格) [[BR]] reason：原因[[BR]] //说明// 返回JSON格式；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 输出结果样例：{"desc":"request 描述","status":状态}[[BR]][[BR]] * _updateSign.jsp （重要） //参数// uid：用户ID[[BR]] viewSign：是否显示用户签名档，true为显示[[BR]] sign：签名档内容，签名档不能超过1200个字[[BR]] reason：原因[[BR]] //说明// 异步调用，用于修改用户的签名档（如果用户已有签名档则修改原有的，如果没有则新增签名档）。[[BR]][[BR]] 输出结果样例：{"desc":"request 描述","status":状态}[[BR]][[BR]] * _updateMedal.jsp //参数// uid：用户ID,可以多个，每个直接用逗号分隔[[BR]] medalId：勋章ID，可以多个，每个直接用逗号分隔[[BR]] action：默认为用户添加勋章，如果action=delete，则取消用户勋章[[BR]] reason：原因[[BR]] //说明// 异步调用，用于修改用户的勋章（可以为授勋或取消勋章）。[[BR]][[BR]] 输出结果样例：{"desc":"描述","status":状态}[[BR]][[BR]] * _userTopicReplies.jsp //参数// fid：版块ID[[BR]] startdate：统计开始时间，long类型的时间数值[[BR]] enddate：统计结束时间，long类型的时间数值[[BR]] topicType：话题分类[[BR]] //说明// 统计当前版块下所有用户所发表主帖被回复的数量，按被回复数量排序，返回JSON格式（包括用户ID和被回复数）。[[BR]] 输出样例：[{"replycounttotal":9,"userid":826717},{"replycounttotal":2,"userid":388},{"replycounttotal":0,"userid":9659992},{"replycounttotal":0,"userid":149561},{"replycounttotal":0,"userid":9673315}][[BR]] * /intf/user/queryUserReplyCount.do //参数//[[BR]] fid：版块ID[[BR]] uid：用户ID[[BR]] from：统计开始时间[[BR]] to：统计结束时间[[BR]] //说明// 统计用户在某个版块，某个时间段回复数，返回JSON格式（需要登录后台，没有缓存）。[[BR]] 输出样例：{"count":1, "uid":903}[[BR]] == [=#p_intf]intf == * _autosave.jsp 自动保存接口(可能仅供本应用调用,已不再使用) * _entry.jsp 本接口取消 * _exscore-member.jsp 用于获得N天内的灌水或精华英雄榜 //参数// type：类别(1,2,3,4,5,6分别表示为score1,score2,score3,score4,score5,score6)[[BR]] count：多少条（默认10）[[BR]] display：返回格式[[BR]] //说明// 返回js/JSON/ssi格式；接口缓存10小时[[BR]] 输出结果样例：[{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名}][[BR]][[BR]] * _forum.jsp 查询版块的主题帖[[BR]][[BR]] //参数// fid=; 版块ID[[BR]] count=10; 返回数量[[BR]] display=table; 返回主题的页面格式，可选table或ul或json[[BR]] pickStr=false; 是否查询版块精华帖[[BR]] //说明// 返回的页面格式可以是table或ul或json[[BR]][[BR]] * _forum_index_auto.jsp 生成汽车论坛"去其他版块"导航内容 此接口仅由应用内部调用 * _forum-today-post.jsp 游戏网首页接口：id、贴数、板块名称、板块logo （重要） //参数//[[BR]] forumIds=1,2,3 板块id串[[BR]] subf=anystring 是否需要包含子版[[BR]] callback 回调函数名[[BR]] //说明//[[BR]] 游戏网首页接口：id、贴数、板块名称、板块logo、描述、子版块的名字和url[[BR]] 输出结果样例: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 得到某天的所有版块帖子的统计 （重要） //参数//[[BR]] filename 8位,以年月日排,如20101001[[BR]] //说明//[[BR]] 此方法是得到某天的所有版块帖子的统计,默认是昨天[[BR]] 输出版块的id、昨日发帖量、回帖量、PV总数[[BR]] 输出结果样例(非json)：1,5,5,100\r\n2,5,5,100\r\n * _hotForums.jsp 显示论坛板块发帖量排行榜 （重要） * _hotForums2.jsp 显示论坛板块发帖量排行榜 //参数// tag=hot_forums; 用于替换的标记名称[[BR]] snum=10; 显示的数据条数[[BR]] noForums=板块一id,板块二id,... 用于过滤不希望上本排行榜的板块，可以不配置。在后台设置隐藏的板块已经自动过滤掉了。[[BR]] callback=; 回调函数名 * _myPosts.jsp 生成嵌入外部页面的我的发帖列表 //参数// memberId：用户id[[BR]] tag：要用来显示内容的element id,这个参数为空则直接用document.write[[BR]] target：是回帖（topics）还是主帖（replies），默认显示主帖。[[BR]] maxSize：列出帖子最大数目,默认10条,不可以长于50条.[[BR]] maxLength：帖子内容最大长度,默认240个英文字符,相当于120个汉字.[[BR]] noCss：有这个参数代表不需要生成css.[[BR]] //说明// 本页面生成一段javascript，用于生成嵌入外部页面的我的发帖列表。调用方式是<script src="${ROOT}/_myPosts.jsp"></script>；接口缓存10小时[[BR]][[BR]] * _onlineUser.jsp 根据版块ID，获取改版块下在线/登录用户数[[BR]][[BR]] //参数// fid=; 要查询的版块ID //说明// 返回数据类型为html块,缓存时间为900毫秒[[BR]][[BR]] * _searchForum.jsp 论坛版块搜索接口[[BR]][[BR]] //参数// q=;关键字[[BR]] pageNo=1;[[BR]] pageSize=20[[BR]] callback=;回调函数名称[[BR]] //说明// 返回数据类型为json,缓存时间为3600毫秒[[BR]][[BR]] * _photos.jsp 获取指定帖子内的图片[[BR]][[BR]] //参数// topicId=; 主题ID[[BR]] postId=; 帖子ID[[BR]] getPos=next/prev; 当没找到时按顺序还是倒序找下一个帖子[[BR]] callback=; 回调函数名 //说明// 获取指定帖子内的图片,没找到时按参数继续找下一贴,以json格式返回[[BR]][[BR]] * _pickForums.jsp 显示论坛板块本周精华帖排行榜 //参数// forums,noForums=; 要包含/排除的版块[[BR]] topicType=; 帖子话题[[BR]] type=f1/f2; 按1级或2级版块分组[[BR]] display=; js/json/ssi[[BR]] count=; 取前几位的版块[[BR]] //说明// 查询版块一周精华数排行,没有区分pick和expick[[BR]][[BR]] * _replies_count_json.jsp 获取主题回帖数[[BR]][[BR]] //参数// tid=; 主题ID[[BR]] //说明// 主题ID可以接受数组形式的参数，以json形式返回[[BR]] 输出样例：{"count":回帖数}[[BR]] * _score-member.jsp 获得N天内的灌水或精华英雄榜 （重要） //参数// type：类别(pick为精华；water为灌水)[[BR]] count：多少条（默认10）[[BR]] days：统计多少天之内的（当天的不计）[[BR]] display：返回格式[[BR]] //说明// 返回js/JSON/ssi格式；接口缓存10小时[[BR]] 输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}][[BR]][[BR]] * _score-member2.jsp 获得N天内的灌水或精华英雄榜 //参数// type：类别(pick为精华；water为灌水)[[BR]] count：多少条（默认10）[[BR]] days：统计多少天之内的（当天的不计）[[BR]] display：返回格式[[BR]] //说明// 返回JSON格式；没有接口缓存[[BR]][[BR]] * _sumPosts.jsp 获取全站的帖子总数和主题总数[[BR]] 输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}][[BR]][[BR]] //参数// callback：回调函数[[BR]] //说明// 返回JSON格式，包括全站主题总数和全站帖子总数[[BR]] 输出样例：([{"posts":全站帖子总数,"topics":全站主题总数}]);[[BR]] * _tocensor.jsp 把tocensor表的数据发送到审核平台 （重要） * _topic.jsp 根据主题ID，获取主题信息[[BR]][[BR]] //参数// tid=; 要查询的主题ID[[BR]] callback=; 回调函数名称[[BR]] //说明// 返回数据类型为JSON[[BR]][[BR]] * _topicReplies.jsp 论坛主题和其下回复页面[[BR]][[BR]] //参数// tag=bbs_topicReplies; 用于替换的标记名称[[BR]] count=10; 列出回复条数[[BR]] topic=; 主题ID，不能为空[[BR]] cl=150; 帖子内容显示字数[[BR]] display=js; 可选js或json[[BR]] callback=; 回调函数，仅返回类型为json时有效[[BR]] //说明// 列出主题下的最新count条回帖，按楼层数逆序排列[[BR]][[BR]] * _topics.jsp[[BR]][[BR]] //参数// subsite=false;是否只查单个版块，默认为false[[BR]] noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块[[BR]] forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块[[BR]] type=new;查询类型。可填new,hot,pick[[BR]] display=ssi;显示方式，支持js,json和ssi[[BR]] css=false; 是否使用CSS架构。true表示使用，这时会以DIV方式输出代码[[BR]] count=10;列出条数[[BR]] messageLength=;帖子内容最大长度,默认没有限制.（目前只有json时生效）[[BR]] days=2;从多少天前的数据开始查询，可填任意整数[[BR]] pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] callback=;当display=json时使用的回调函数名称[[BR]] //说明// 可以查看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里查找。[[BR]][[BR]] * _topics_id.jsp[[BR]][[BR]] //参数// ids=; 主题ID，多个主题ID用半角逗号分隔[[BR]] count=10; 返回数量[[BR]] display=; 默认显示主题所有相关信息。若display参数值不为空，则只返回参数值的信息，多个值用半角逗号分隔。例如：display=title,replyCount 则只返回主题的title和replyCount，其余不返回。[[BR]] cl=250; 主题帖子内容的显示长度[[BR]] //说明// 返回数据类型为JSON，可指定返回的字段[[BR]] 输出样例：([{"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":是否精华帖}]);[[BR]] * _topics2.jsp 论坛主题列表javascript接口[[BR]][[BR]] //参数// forum=;版块ID。查找的信息也会包含其子版块[[BR]] type=new;查询类型。可填new,hot,pick[[BR]] count=10;列出条数[[BR]] pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] callback=;回调函数名称[[BR]] //说明// 可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找[[BR]] 输出样例：([{"createAt":"创建时间","forumId":版块ID,"forumName":"版块名称","forumUrl":"版块URL","lastPostAt":"最后回复时间","rate":查看数比例值,"rateReply":回复数比例值,"replyCount":回复数,"rewardAmount":悬赏金额,"rewardRemain":悬赏余额,"title":" 标题 ","topicId":主题ID,"topicUrl":"主题URL","userId":用户ID,"userName":"用户名称","userUrl":"用户个人中心链接","viewCount":查看数}]);[[BR]] * _topics-css.jsp 论坛主题列表javascript接口[[BR]][[BR]] //参数// tag=bbs_topics; 用于替换的标记名称[[BR]] forum=;版块ID。查找的信息也会包含其子版块[[BR]] type=new;查询类型。可填new,hot,pick[[BR]] display=js;显示方式，支持js,json和ssi[[BR]] count=10;列出条数[[BR]] callback=;当display=json时使用的回调函数名称[[BR]] //说明// 可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找[[BR]][[BR]] * _userExtTopics.jsp 论坛用户发扩展主题数接口 //参数// uid：用户ID[[BR]] extId：帖子的扩展ID(1:盖楼帖 2:为活动贴 3:交易帖 4:链接帖 5:一帖多发虚拟帖 6:达人牛帖)[[BR]] dateFrom：开始日期[[BR]] dateTo：结束日期[[BR]] ck：回调函数[[BR]] //说明// 查询用户在一个时间段内的发扩展主题数，未包括已删除的；接口缓存10小时[[BR]] 输出样例说明：{"count":主题数}[[BR]][[BR]] * _userTopics.jsp 论坛用户发主题数接口 //参数// uid：用户ID[[BR]] postCount：最少回帖数[[BR]] dateFrom：开始日期[[BR]] dateTo：结束日期[[BR]] ck：回调函数[[BR]] //说明// 查询用户在一个时间段内的发扩展主题数和精华数，未包括已删除的；接口缓存10小时[[BR]] 输出样例说明：{"count":主题数, "picks":精华数}[[BR]][[BR]] * _picksPeriod.jsp 获取一段时间内精华帖接口 //参数// startdate：开始日期（需要传微秒形式）[[BR]] enddate：结束日期（需要传微秒形式）[[BR]] fid：板块ID[[BR]] pick：1查精华 0查所有[[BR]] topicType：话题类型(activity/vote/trade/html)[[BR]] //说明// 获取一段时间内精华帖；接口没有使用缓存[[BR]][[BR]] * _friends.jsp //参数// uids：用户id,用半角逗号分隔[[BR]] tag：要用来显示内容的element id,这个参数为空则直接用document.write[[BR]] //说明// (itbbs:似乎只是出一段用户信息的html,跟好友无关,不知道哪里用到) * _topicAndTops.jsp //参数// count：列出条数[[BR]] forum: 版块id[[BR]] pick：1表示只列精华,默认不限[[BR]] reply：回复数至少有[[BR]] days：只查最近多少天的[[BR]] tag：用于替换的标记名称[[BR]] top: 置顶帖条数[[BR]] callback: 回调函数名[[BR]] display: js/ssi/json[[BR]] //说明// 功能大致同intf/common/_topics.jsp,但是是出某一版块带置顶的帖子[[BR]][[BR]] * prodTopic.jsp 与_topicAndTops.jsp一模一样 * _forums.jsp //参数// of=1: 版块id showHidden=0: 是否显示隐藏版块 0以外显示 showRedirect=0: 是否显示有跳转链接的版块 0以外显示 //说明// 提供给软件下载，显示版块列表[[BR]][[BR]] == [=#p_action_user]action/user == * active.jsp 论坛激活用户接口[[BR]][[BR]] （重要） //参数// uid：用户ID[[BR]] username：用户名[[BR]] nickname：昵称[[BR]] appCode：应用代码(暂时无用)[[BR]] //说明// 调用机器IP需要在后台配置ScoreClientMachine范围内；如果根据用户ID找不到该用户，则新建一个用户，并激活。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * actived.jsp 论坛检查用户是否激活接口[[BR]][[BR]] （重要） //参数// uid：用户ID数组（用户“,”分隔）[[BR]] //说明// 调用机器IP需要在配置ScoreClientMachine范围内；传入用户ID数组，输出未激活的用户ID。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * admin_forums.jsp 论坛获取用户管理角色接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] //说明// 用于在帖子页头衔上面显示。[[BR]][[BR]] * check_favorite.jsp 论坛判断当前登录用户是否收藏了该帖子接口[[BR]][[BR]] （重要） //参数// tid：主题ID[[BR]] fid：板块ID[[BR]] //说明// 如果是收藏了，则返回收藏ID，否则返回-1；如果tid参数不为空，则优先判断是否收藏了改帖子，如果tid为空，fid不为空，才判断是否收藏了该板块；需要用post方式提交[[BR]] 输出结果样例：0/1[[BR]][[BR]] * contribution_update.jsp 论坛调用户贡献接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] contribution：需要增加的贡献值[[BR]] reason：原因[[BR]] //说明// 需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * delete_posts.jsp 论坛清除用户发帖接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] reason：原因[[BR]] //说明// 必须使用post方式提交。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * exscore_update.jsp 论坛调用户扩展积分接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] exscore：需要增加的积分值[[BR]] reason：原因[[BR]] type：扩展积分[[BR]] //说明// 需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * favorite.jsp 论坛用户收藏接口[[BR]][[BR]] //参数// fid：板块ID[[BR]] tid：主题ID[[BR]] //说明// 当前登录用户收藏包括板块或主题，收藏成功后会发动态到个人中心，必须使用post方式提交。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * favorite_delete.jsp 论坛删除当前登录用户收藏接口[[BR]][[BR]] //参数// id：需要删除的收藏id[[BR]] //说明// 支持批量删除，id用“,”分隔。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * favorite_forums.jsp 论坛获取当前登录用户收藏板块接口[[BR]][[BR]] //参数// pageNo：第一页，默认第一页[[BR]] pageSize：每页显示多少条，默认10条[[BR]] //说明// 返回json数组格式。[[BR]] 输出结果样例：{"forumList":[{"favoriteId":收藏ID,"forumAdmins":[{"forumAdminId":版主用户ID,"forumAdminName":版主用户名}],"lastPostAt":最后发表时间,"lastPosterId":最后发表人 ID,"lastPosterNickname":最后发表人名,"name":板块ID,"postCount":回帖数,"todayPostCount":今天回帖数,"topicCount":发帖数,"url":板块链接}],"pageCount":总页数,"pageNo":页码,"pageSize":每页显示数据量,"total":总数据量}[[BR]][[BR]] * favorite_topics.jsp 论坛获取当前登录用户收藏主题接口[[BR]][[BR]] //参数// pageNo：第一页，默认第一页[[BR]] pageSize：每页显示多少条，默认10条[[BR]] //说明// 返回json数组格式。[[BR]] 输出结果样例：[{"author":用户名,"authorId":用户ID,"createAt":创建时间,"favoriteId":收藏ID,"lastPostAt":最后发表时间,"name":用户名,"replyCount":回复数,"url":主题链接,"views":查看数}][[BR]][[BR]] * lock.jsp 论坛锁用户接口[[BR]][[BR]] //参数// fid：锁单个板块ID[[BR]] uid：锁单个用户ID[[BR]] fids：批量锁板块ID[[BR]] uids：批量锁用户ID[[BR]] reason：原因[[BR]] expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）[[BR]] type：如果是all，则锁全站，否则锁板块[[BR]] //说明// 支持批量锁用户；非管理员角色，默认会发系统消息给用户；需要使用post方式提交。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明,"lockId":锁ID，"lockDesc":锁描述}][[BR]][[BR]] * lock_all.jsp 论坛锁用户接口[[BR]][[BR]] //参数// uid：锁单个用户ID[[BR]] reason：原因[[BR]] expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）[[BR]] //说明// 把单个用户锁全站；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * medal_update.jsp 论坛更新用户勋章接口[[BR]][[BR]] //参数// uid：单个用户ID[[BR]] reason：原因[[BR]] medalId：勋章ID[[BR]] //说明// 如果传入的勋章ID不在用户已有勋章范围内，则新增；如果用户已有的勋章ID不在传入勋章范围内，则删除该勋章。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * propstr_update.jsp 论坛更新用户自定义头衔接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] reason：原因[[BR]] propstr：自定义头衔[[BR]] //说明// 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * recent_forums.jsp 论坛获取当前登录用户最近浏览板块接口[[BR]][[BR]] //参数// //说明// 根据cookie--"visitedfid"找到用户最近浏览的板块，返回json数组格式[[BR]] 输出结果样例：[{"url":板块链接,"name":版块名,"topicCount":主题数,"postCount":回帖数,"lastPosterId":最后发表人ID,"lastPosterNickname":最后发表人昵称,"lastPostAt":最后发表时间,"todayPostCount":今天回复数,"forumAdmins":{"forumAdminId"：版主ID,"forumAdminName":版主名称}}][[BR]][[BR]] * score_update.jsp 论坛调用户积分接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] reason：原因[[BR]] score：需要增加的积分值[BR]] //说明// 需要用post方式提交，调整完之后会发送一条系统消息给用户[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * sign_disable.jsp 论坛屏蔽用户签名接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] username：用户名[[BR]] uids：多个用户ID[BR]] fid：板块ID（用于判断权限）[[BR]] reason：原因[[BR]] //说明// 支持批量处理用户签名；需要用post方式提交；屏蔽完之后会发送系统消息[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * sign_enable.jsp 论坛激活用户签名接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] username：用户名[[BR]] uids：多个用户ID[BR]] fid：板块ID（用于判断权限）[[BR]] reason：原因[[BR]] //说明// 支持批量处理用户签名；需要用post方式提交；激活完之后会发送系统消息[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * unlock.jsp 论坛用户解锁接口[[BR]][[BR]] //参数// lockId：锁ID[[BR]] reason：原因[[BR]] //说明// 根据锁ID解锁用户；解锁完之后完之后会发送系统消息[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * unlock_all.jsp 论坛用户解锁（全站）接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] reason：原因[[BR]] //说明// 把单个用户全站解锁；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * unlockByUserId.jsp 论坛用户解锁接口[[BR]][[BR]] //参数// uids：用户ID[[BR]] reason：原因[[BR]] //说明// 按用户id对用户全站被锁的模块都解锁；支持批量方式；需要post方式提交；解锁完之后完之后会发送系统消息[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * update.jsp 论坛修改用户信息接口[[BR]][[BR]] //参数// nickname：昵称[[BR]] sign：个性签名[[BR]] hintMessage：是否暗示消息(?)[[BR]] propNum：用户所在城市ID[[BR]] propStr：扩展字段[[BR]] //说明// 修改当前登录用户个性签名（自动激活）、扩展字段（如果是汽车网则包括地区ID）、昵称、hintMessage；需要用post方式提交[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * update_contact.jsp 论坛修改用户联系方式接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] contact：联系方式[[BR]] reason：原因[[BR]] //说明// 家居网专有(以后可以废弃，改用controller方式)[[BR]][[BR]] * updateProp.jsp 论坛修改用户信息接口[[BR]][[BR]] //参数// propNum：用户所在城市ID[[BR]] propStr：拥有车型ID;车型名,如没有车型的填写车系ID;车系名[[BR]] type: 为0时,更新两个,当为1时,更新propStr,当为2时,更新propNum[[BR]] //说明// 修改当用户扩展字段（如果是汽车网则包括地区ID）；需要用post方式提交[[BR]] 输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] * user_json.jsp 论坛获取单个用户信息接口[[BR]][[BR]] //参数// id：用户ID[[BR]] name：账号[[BR]] callback: 回调函数[[BR]] //说明// 返回json,信息包括用户ID、账号、昵称、注册时间、积分、所在角色组名[[BR]] 输出结果样例：{"createAt":创建时间,"groupName":会员组名,"name":用户名,"nickname":昵称,"score":积分,"userId":用户ID}[[BR]][[BR]] * user_setting_json.jsp 论坛获取单个用户信息接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] name：账号[[BR]] callback: 回调函数[[BR]] //说明// 包括用户所有信息，如果不是审核员，还会返回用户管理角色列表。[[BR]] 输出结果样例：{"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":是否显示签名}[[BR]][[BR]] == [=#p_rest]rest == * forums.jsp 论坛列表页和发主题接口 （重要）[[BR]][[BR]] //参数// forumId：板块ID[[BR]] title：主题标题[[BR]] category：发主贴时的帖子类别 1性福，2婆媳，3情感，4职场，5姐妹，6邻里[BR]] message：内容[[BR]] pageNo：第几页[[BR]] pageSize：每页显示多少条[[BR]] anonymous：是否匿名 1为匿名 0为不匿名[[BR]] message：内容 (发帖时传)[[BR]] agent：发帖终端类型（各网根据具体情况传入不同参数，可参照：http://rdtrac.pc.com.cn/bbs/wiki/developRule） // 返回值// 成功返回 {"Location":帖子url, "hasGold":是否加了金币true/false, "goldCount":金币数量} 失败返回 {"status":, "message":} //说明// POST:发帖;GET:列表页 [[BR]] 注:销售配合开始： 2012-11-28至2012-12-04、2012-12-13至2012-12-20 在forum16655版块置顶帖子3431731。 [[BR]][[BR]] * topics.jsp 论坛帖子页和发回帖接口（重要）[[BR]][[BR]] //参数// topicId：主题ID[[BR]] title：主题标题[[BR]] reason：删帖原因[[BR]] message：内容[[BR]] pageNo：第几页[[BR]] anonymous：是否匿名 1为匿名 0为不匿名[[BR]] replyToId：回复楼层的id[[BR]] pageSize：每页显示多少条[[BR]] desc：是否按照楼层降序排序，如果不传该参数，则按升序排[[BR]] _method：DELETE和PUT方式需要传该参数（POST方式提交）[[BR]] //说明// POST:回帖;GET:帖子页;DELETE:删主题;PUT:更新主题。 [[BR]] //返回说明// DELETE:没有返回内容 [[BR]] PUT:Location:帖子链接 [[BR]] POST:Location:帖子链接 [[BR]] GET{"pageNo":第几页,"pageSize":每页显示条数,"postList":[{"author":{"name":"用户名","nickname":呢称,"userId":用户ID},"createAt":创建时间,"floor":楼层,"message":内容,"postId":回帖ID,"status":状 态}]} [[BR]] [[BR]] * topics-posts.jsp 论坛回帖修改和删除接口（重要） [[BR]][[BR]] //参数// topicId：主题ID[[BR]] postId：回帖ID[[BR]] reason：删帖原因[[BR]] message：内容[[BR]] //说明// DELETE:删帖;PUT:更新。 [[BR]] //返回说明// 没有返回内容[[BR]][[BR]] * topics-hot.jsp 论坛热榜接口 [[BR]][[BR]] //参数// range：范围，"week"表示查一周热帖排行；"month"表示查一个月热帖排行；不传则查一天热帖排行[[BR]] count：获取多少条数据[[BR]] //说明// 返回JSON数组格式。[[BR]][[BR]] * topline/tree.jsp 论坛获取直接子版块信息接口 [[BR]][[BR]] //参数// root：板块ID[[BR]] callback：回调函数[[BR]] //说明// [[BR]][[BR]] == [=#p_util]util == * 119.jsp [[BR]] //功能//[[BR]] 动态修改spring容器中bean的属性[[BR]] //参数// bean : spring bean id属性 [[BR]] * adminrole.jsp [[BR]] //功能//[[BR]] 根据用户ID或版块ID来查找管理员角色 [[BR]] * ai_findpxurl.jsp [[BR]] //功能//[[BR]] 通过topicId查看pickax的url [[BR]] * ai_topic_post.jsp [[BR]] //功能//[[BR]] 根据topicId来查看主题状态和该主题下的post状态 [[BR]] * ai_topic_type_change.jsp [[BR]] //功能//[[BR]] 修改主题的话题类型 [[BR]] * censor.jsp [[BR]] //功能//[[BR]] 此接口接收的是信息队列发送过来审核平台的信息 [[BR]] 不再使用,功能转移到controller [[BR]] * d_topic.jsp [[BR]] //功能//[[BR]] 此页面用于过滤要删除的主题 [[BR]] * d.jsp //功能//[[BR]] 此页面用于过滤要删除的帖子 [[BR]] * file.jsp //功能// 此接口供各个服务器上的定时任务，获取计数器数据文件 [[BR]] 参数如下：[[BR]] method : ls(列出文件名)[[BR]] path : 0 | 15[[BR]] return：如果在path目录下存在数据文件，则打印文件名[[BR]] 或[[BR]] method : get(获取计数器数据文件)|rm(删除服务器上的计数器数据文件)[[BR]] path : 0 | 15[[BR]] filename: 数据文件，如200811301200[[BR]] return：如果在path目录下存在数据文件，则打印文件内容[[BR]] 或[[BR]] method : rm(删除服务器上的计数器数据文件)[[BR]] path : 0 | 15[[BR]] filename: 数据文件，如200811301200[[BR]] return：void[[BR]] * import_photo_post.jsp //功能//[[BR]] 图片分离补录功能,如果某个帖子的图片信息未保存到post_photo表中，可以用该接口来补录 [[BR]] //参数//[[BR]] topicId : 主题id,type:topic [[BR]] 或[[BR]] postId : 帖子id,type:post [[BR]] * ks_autobbs.jsp //功能//[[BR]] 从汽车网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] * ks_babybbs.jsp //功能//[[BR]] 从亲子网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] * ks_bbs.jsp [[BR]] //功能//[[BR]] 从电脑网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] * ks_gamesbbs.jsp [[BR]] //功能//[[BR]] 从游戏网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] * ks_ladybbs.jsp [[BR]] //功能//[[BR]] 从女性网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子[[BR]] * logsetting.jsp //功能//[[BR]] 设置EnvFilter的log level（开发人员调试用）[[BR]] * mc.jsp //功能//[[BR]] 查看或清除mc缓存[[BR]] //参数//[[BR]] action: delete|update|view(默认值)[[BR]] key: mc缓存key[[BR]] * monitor.jsp //功能//[[BR]] 查看应用运行效率的利器[[BR]] * monitor2.jsp //功能//[[BR]] 查看应用运行效率的利器[[BR]] * move_forum_topics.jsp //功能//[[BR]] 将某个版块的主题移动到指定目标版块 * online.jsp //功能//[[BR]] 获取在线用户的uid列表[[BR]] //参数// cb: 回调函数[[BR]] ids: 用户id列表，用逗号分隔[[BR]] //返回//[[BR]] 在线用户数组 * poster.jsp （重要） //功能//[[BR]] 灌水机接口[[BR]] //参数//[[BR]] uid 用户ID[[BR]] method 有2种方式，发帖与发主题，reply为发帖，默认为发主题[[BR]] content 帖子内容[[BR]] tid 主题ID[[BR]] fid 版块ID[[BR]] type 主题类别,String 不验证是否当前版块存在,但最好是存在的,否则没法通过类别过滤[[BR]] title 标题[[BR]] 发表回帖需要uid,method=reply,content,tid[[BR]] 发表主题需要uid,content,fid,type,title[[BR]] uid,tid,fid用find方法,如论坛没有,则抛出错误[[BR]] //返回//[[BR]] json数据,status=0时，发帖成功[[BR]] * px.jsp[[BR]] //功能//[[BR]] 向快聚接口发送主题[[BR]] //参数//[[BR]] tid:主题id * sync.jsp //功能//[[BR]] 清除各种常驻内存配置对象的jsp，需要从服务器端发出请求才行[[BR]] 合法服务器的列表在appname = System, appkey = servers应用配置项中[[BR]] * test_ip.jsp[[BR]] //功能// 本jsp用于测试调用方的服务器ip[[BR]] * text.jsp[[BR]] //功能// 根据logid查询回帖内容[[BR]] //参数// logid: post备份日志id[[BR]] date: post_text_history_分表后缀 [[BR]] //返回//[[BR]] 回帖内容 * untop_deleted_top.jsp[[BR]] //功能//[[BR]] 取消所有全站置项[[BR]] * upload.jsp //功能// 用flash上传图片[[BR]] * user_score.jsp //功能//[[BR]] 查看用户积分，贡献等信息[[BR]] //参数[[BR]] callback:回调函数(必须) [[BR]] ids:用户id列表，用逗号分隔(必须) [[BR]] //返回 json格式数组[[BR]] ck([{'userId':388,'score':194,'contribution':57,'level':4,'totalLevel':19,'title':'太平洋舰队上等兵','next':200}]);[[BR]] * visited_forum_list.jsp //功能// 列举指定的版块的信息 //参数// type : 返回的数据的格式(html|json)[[BR]] fids : 版块id列表，用'D'分隔[[BR]] //返回[[BR]] json格式数组[[BR]] [{"forumId":4,"name":"一级兄弟版块2","url":"http://localhost.pcauto.com.cn/bbs7/forum-4.html"}] * /util/roleright.do [[BR]] //功能//[[BR]] 查看roleright内存 * /util/userforumrole.do [[BR]] //功能//[[BR]] 查看userforumrole内存 * /util/lock.do [[BR]] //功能//[[BR]] 查看锁用户，锁IP内存 == [=#p_do]do == * /intf/forum/picks.do [[BR]] //功能//[[BR]] 查询版块精华接口（查询bbs7_pick表），接口缓存6小时 [[BR]] //参数//[[BR]] fid：板块ID [[BR]] count：获取条数（默认5条）[[BR]] days：多少天内发的帖子（默认2天）[[BR]] orderby：排序条件（默认排序字段是createAt）[[BR]] needContainImage：是否必须包含图片 [[BR]] maxLength:帖子内容最大长度 [[BR]] callback:回调函数 [[BR]] //返回 [[BR]] json格式数组 [[BR]] cb([{"forumId":板块ID,"fourmUrl":板块地址,"topicId":主题ID,"topicUrl":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"viewCount":查看数,"authorName":作者昵称,"authorUrl":作者个人中心地址,"cover":封面,"title":标题}]) * user/getScore.do 获取论坛用户积分接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] date：时间 格式为yyyy-MM[[BR]] 输出结果：返回json格式(包含createat创建时间，amount积分数量，slot积分类型，reason评分原因，createbyid评分的用户id)[[BR]] * user/updateNickName.do 从消息队列中接收各网修改昵称的消息[[BR]][[BR]] //参数// msg:格式为{"appName":"common","actionType":"updateNickName","msg":{"accountId":388,"nickName":"fishOK2"}} [[BR]] 输出结果：返回json格式[[BR]] * /intf/forum/pickYesterday.do [[BR]] //功能//[[BR]] 查询版块精华接口（查询bbs7_pick表,以前一天的回复数排序），接口缓存24小时 [[BR]] //参数//[[BR]] fids：板块ID(多个以逗号分隔) [[BR]] count：获取条数（默认5条）[[BR]] maxLength:帖子内容最大长度 [[BR]] callback:回调函数 [[BR]] //返回 [[BR]] json格式数组 [[BR]] cb([{"forumId":板块ID,"fourmUrl":板块地址,"topicId":主题ID,"topicUrl":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"viewCount":查看数,"authorName":作者昵称,"authorUrl":作者个人中心地址}]) * /intf/topics.do 根据tid，获取主题基本信息,支持批量，中间用逗号分隔[[BR]][[BR]] //参数// tids:帖子ID [[BR]] callback:回调函数 [[BR]] 输出结果：返回json格式 [[BR]] cb([{"fid":板块ID,"uid":作者id,"tid":主题ID,"uri":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"view":查看数,"userName":作者名称,"nickName":作者昵称,"floor":总楼层，"containImage":是否包含图片,"censor":审核状态}]) * /intf/forums.do 根据fid，获取版块基本信息，支持批量，中间用逗号分隔[[BR]] //参数// fids:帖子ID [[BR]] callback:回调函数 [[BR]] 输出结果：返回json格式 [[BR]] 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 查询用户的帖子[[BR]][[BR]] //参数// uid:帖子ID [[BR]] type:类型（默认为topic） [[BR]] pageNo:当前页 [[BR]] pageSize:每页数量 [[BR]] 输出结果：返回页面intf/myPost.jsp [[BR]] * /intf/user/query/favorite.do 去查询用户的收藏的帖子及发的帖子[[BR]][[BR]] //参数// uid:帖子ID [[BR]] type:类型（默认为topic） [[BR]] pageNo:当前页 [[BR]] pageSize:每页数量 [[BR]] 输出结果：返回页面intf/userFavorite.jsp [[BR]] * /intf/user/memcp.do 去查询用户个人资料、签名[[BR]] //参数// 用户登录后即可。 输出结果：返回页面intf/memcp.jsp [[BR]] * /mobile/topics.do 去查询论坛主题列表 [[BR]] //参数// help:接口帮助（为true时返回接口具体使用介绍） [[BR]] 输出结果：返回页面intf/memcp.jsp [[BR]] * /intf/forum/pickYesterday.do 查询版块精华接口 以 前一天回复数排序 查log表[[BR]] //参数// count=10返回的数据条数[[BR]] callback:回调函数 [[BR]] maxLength=240回调函数 [[BR] help:接口帮助 [[BR]] fids:版块ID(多个以，分隔) [[BR]] fids=1则查全站[[BR]] 接口缓存12小时 [[BR]] 输出结果：返回json格式[[BR]] [{ authorName-用户名: "舍文", [[BR]] authorUrl-用户url: "http://my.pconline.com.cn/25542092", [[BR]] createAt-帖子创建时间: "2014-05-08 16:01:55", [[BR]] forumId-帖子所在的板块id: 1, [[BR]] forumUrl-板块url: "http://itbbs.pconline.com.cn", [[BR]] lastPostAt-帖子最后回复的时间: "2014-07-15 20:47:09", [[BR]] message-帖子内容: "[图] 摄影器材:尼康 D4 拍摄参数： 曝光: 光圈: 快门: ISO: 曝光补偿: [图] 摄影器材:尼康 D4 拍摄参数： 曝光: 光圈: 快门: ISO: 曝光补偿: [图] 摄影器材:尼康 D4 拍摄参数...", [[BR]] replyCount-回复数: 39, [[BR]] title-帖子标题: "<杀手与摩托>", [[BR]] topicId-帖子id: 51415999, [[BR]] topicUrl-帖子url: "http://itbbs.pconline.com.cn/bbs/51415999.html", [[BR]] uid-用户id: 25542092, [[BR]] userFaceUrl-用户头像url: "http://i1.3conline.com/images/upload/upc/face/25/54/20/92/25542092_120x120", [[BR]] viewCount-帖子查看数: 39019}] [[BR]] * /intf/topics/adminYesterdayHot.do 查询活动排行榜接口 [[BR]] //参数// [[BR]] count：获取多少条，默认为5 [[BR]] callback:回调函数，可以为空 //返回json格式// [[BR]] [{ [[BR]] replyCount-回复数:1173329, [[BR]] tid-帖子ID:2070650, [[BR]] title-帖子标题:"珍护不上火，宝宝便轻松，注册抢楼赢双重大礼", [[BR]] views-访问量:1177503 [[BR]] }] [[BR]] count大于10当10处理 [[BR]] * /intf/user/treasureRankingList.do 查询妈咪财富榜接口 [[BR]] //参数// [[BR]] count：获取多少条，默认为5 [[BR]] callback:回调函数，可以为空 [{ [[BR]] nickname-:"HelloWorld",用户昵称 [[BR]] score-:2650,用户金币数 [[BR]] uid-:123456,用户id [[BR]] }] [[BR]] count大于10当10处理，按用户金币降序排列，不包含绑定后台帐号的管理员 [[BR]] * /intf/forum/getPicks.do 查询版块精华接口[[BR]] //参数// [[BR]] forums=1;需要查询的版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块 [[BR]] noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块 [[BR]] pickType=pickA;精华类型，可填all,pickA,pickB,pick1,pick2,pick3,pick4,pick5;其中pickA和pickB查的都是普通精华，all为查询所有精华 [[BR]] pageNo:当前第几页 [[BR]] pageSize:每页显示的数量，默认为10条 [[BR]] maxLength:帖子内容需要截取的长度，默认240个字节 [[BR]] callback:回调函数 [[BR]] ie=gbk;输出内容的编码格式 [[BR]] showImage=false;显示图片 [[BR]] requestScr=wap，默认为pc，当requestScr=wap时，结果中的images[]帖子图片尺寸大小为240*160[[BR]] showSubject=false;显示论坛话题分类 [[BR]] cacheTime=3600;缓存时间，单位为秒 [[BR]] //返回json格式// [[BR]] {status:,desc:,topics:[{forumId:,forumName:,forumSubjects:,topicId:,title:,message:,userName:,userId:,userFaceUrl:,images:,createAt:,views:,replyCount:,pickTypes:{"pick":,"pick1":,"pick2":,"pick3":,"pick4":,"pick5":}}]pageNo:,pageSize:,total:} * /intf/forum/getWeekHots.do 查询一周热帖接口 //参数// size:排行榜长度，默认30，最大50, [[BR]] maxLength:帖子内容截取长度，默认240, [[BR]] callback:回调函数名称, [[BR]] 接口结果缓存1个小时 [[BR]] 输出结果：返回json格式 [[BR]] {total:,topics:[{authorName:,authorUrl:,createAt:,forumId:,forumUrl:,lastPostAt:,message:,newReplyCount（新增回复数）:,replyCount:,tid:,title:,topicId:,topicUrl:,type:,uid:,updateAt:,userFaceUrl:,viewCount:}]} * /intf/forum/getSameAge.do 查询同龄发帖接口[[BR]] //参数// [[BR]] fid:查询论坛ID [[BR]] babyBirthday:出生年月（格式yyyyMM） [[BR]] pageNo:页码 [[BR]] pageSize:每页条数，默认为10条。可选范围1-100 [[BR]] maxLength:主题内容截取长度，字节。默认240个字节 [[BR]] orderby:排序列名。默认按主题发布时间(postat)。可选范围["postat","replycount","lastpostat"]，降序 [[BR]] requestScr:用途。可选范围["pc","wap"]此参数影响输出主题中的图片URL，wap将输出小尺寸的图片URL [[BR]] callback:回调函数 [[BR]] //返回json格式// [[BR]] {"data":{"result":[{"authorId":,"authorName":,"authorUrl":,"bonus":,"createAt":,"forumId":,"hasDoctorReply":, "images":,"lastPostAt":,"message":,"replyCount":,"title":,"topicId":,"type":,"viewCount":}],"total":},"status":} * /intf/user/queryUserPost.do 查询用户的主帖、精华帖、回帖[[BR]][[BR]] //参数// uid=登陆用户id[[BR]] type=topic:要查询的帖子类型 pick精华, topic主贴，reply 回帖 [[BR]] pageSize,pageNo,maxLength,callback,ie,help [[BR]] 输出结果：返回json格式[[BR]] cb({status,desc,uid,pageNo,pageSize,total, topics[{topicId,secretForum,title,message,authorName,createAt,views,replyCount}]}) 针对主贴和精华贴 [[BR]] 针对于回帖 cb({status,desc,uid,pageNo,pageSize,total, topics[{topicId,secretForum,title,authorName,createAt,views,replyCount,image,categoryId,category,replyContent,replyAuthorName,replyAuthorId,replyTime,fid,pid,floor}]}) * /intf/user/queryUserPostCounts.do 查询用户的主帖数量、精华帖数量、回帖数量[[BR]] //参数// [[BR]] uid=登陆用户的id,help,[[BR]] //返回json格式// [[BR]] {topicCount,pickCount,replyCount} * /topic/identity.do 查询帖子的身份[[BR]] //参数// [[BR]] tids=; 帖子id列表，以逗号隔开[[BR]] identity=secretForum;帖子身份 secretForum为是否属于私密板块, anonymous为是否为匿名帖子 //返回json格式// [[BR]] {identity:,status -1(异常)/0(正常), topics:[{tid, on(true/false)}]} * /singleForum/topics.ajax 查询单个板块下的主题列表[[BR]] //参数// [[BR]] fid=; 板块id[[BR]] order=postat;排序类型:postat按创建时间,replyat按回复时间,replycount按回复数量 //返回json格式// [[BR]] {pageNo,pageSize, total,fid:,status -1(异常)/0(正常), topics:[{}]} == [=#p_mobile]mobile == * /mobile/searchTopics.do 通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]] //参数// [[BR]] searchWord=; 关键字[[BR]] pageSize,pageNo,maxLength;[[BR]] searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容[[BR]] //返回json格式// [[BR]] {status,total,pageSize,pageNo,topics[{topicId, title,message,uid,createAt,view,replyCount,secretForum}]} * /mobile/baby/getNewTopics.do 查询最新帖子[[BR]] //参数// [[BR]] ie,fids,noFids,pageNo,pageSize,maxLength[[BR]] pageSize,pageNo,maxLength,cacheTime;[[BR]] //返回json格式// [[BR]] {fids,pageNo,pageSize,total,topics[{forumId:,forumName:,forumUrl:,topicId:,title:,message:,userName:,userId:,userFaceUrl:,images:,createAt:,views:,replyCount:,rewardAmount,rewardRemain,replyCount,viewCount,floor,images,categoryId,category}]}]} * /mobile/baby/getSecretTopics.do 查询私密圈的最新帖子包括话题[[BR]] //参数// [[BR]] type=1,查询的帖子类型，1为私语， 2为话题[[BR]] ie,pageSize,pageNo,maxLength,cacheTime;[[BR]] //返回json格式// [[BR]] {fids,pageNo,pageSize,total,topics[{forumId:,forumName:,forumUrl:,topicId:,title:,message:,userName:,userId:,userFaceUrl:,images:,createAt:,views:,replyCount:,rewardAmount,rewardRemain,replyCount,viewCount,floor,images,categoryId,category}]}]} * /mobile/getBestieTopics.do 查询闺蜜圈的最新帖子包括话题[[BR]] //参数// [[BR]] ie,pageSize,pageNo,maxLength,callback,cacheTime,fid,help;[[BR]] //返回json格式// [[BR]] {fids,pageNo,pageSize,total,topics[{replyTime,replyAuthorId,replyAuthorName,replyContent,message,viewsNum,commentNum,categoryId,,category,title,pid,topicId,topicAuthorId,source:0(私语)/1(话题)}]}]}