Changes between Initial Version and Version 1 of InterfaceUrl


Ignore:
Timestamp:
03/10/2014 03:54:28 PM (12 years ago)
Author:
chenchongqi
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • InterfaceUrl

    v1 v1  
     1= 接口列表 = 
     2 
     3== 目录 == 
     4* [#p_intf_common intf/common] 
     5* [#p_intf_special intf/special] 
     6* [#p_intf_user intf/user] 
     7* [#p_intf intf] 
     8* [#p_action_user action/user] 
     9* [#p_rest rest] 
     10* [#p_util util] 
     11* [#p_do do] 
     12 
     13== [=#p_intf_common]intf/common == 
     14* _topics.jsp   论坛主题列表接口(重要)[[BR]][[BR]] 
     15  //参数// 
     16    subsite=false;是否只查单个版块，默认为false。[[BR]] 
     17    当subsite=false时，支持以下参数：[[BR]] 
     18        noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块[[BR]] 
     19        forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块。[[BR]] 
     20        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]] 
     21        pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] 
     22        orderby=;查询类型为hot时，默认按回复数(replyCount)排序，要按点击数(view)排序就需要加此配置。查询类型为pick时，默认按发帖时间(createAt)排序，要按点击数(view)排序就需要加此配置。[[BR]] 
     23    当subsite=true时，支持以下参数：[[BR]] 
     24        forums=;只能接受一个版块ID，多个版块取第一个[[BR]] 
     25        top=3;置顶帖条数[[BR]] 
     26        days=2;从多少天前的数据开始查询，可填任意整数[[BR]] 
     27        type=new;可填new,hot,pick,top[[BR]] 
     28        extId=;6为达人牛帖(暂未实现)[[BR]] 
     29        reply=-1;回复数大于等于多少，为-1时没有限制[[BR]] 
     30        replyMax=-1;回复数最大是少于多少，为-1时没有限制[[BR]] 
     31        topicType=;话题类别，默认为不填[[BR]] 
     32        topicTypeUTF8=;话题类别UTF8格式处理，默认为不填[[BR]] 
     33    count=10;列出条数[[BR]] 
     34    display=json;显示方式，支持json和ssi[[BR]] 
     35    maxLength=240;帖子内容最大长度,默认240个英文字符,相当于120个汉字.（目前只有json时生效）[[BR]] 
     36    faceWidth:需要返回头像时设定头像的宽度[[BR]] 
     37    callback=;当display=json时使用的回调函数名称[[BR]] 
     38     
     39  //说明// 
     40    可以查看4种形式的主题列表，最新，顶置，最热，精华。根据subsite参数确定从哪个表查找[[BR]] 
     41    如果subsite=true，直接从bbs7_topic_xx表中读取数据[[BR]] 
     42    如果subsite=false，最新的主题从bbs7_new_topic里查找,最热的主题从bbs7_hot_topic,bbs7_hot_topic7,bbs7_hot_topic30,bbs7_hot_topic_all里查找，精华的主题从bbs7_pick里查找。[[BR]][[BR]] 
     43    输出内容包括：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]] 
     44* _topic.jsp    根据主题ID，获取主题信息[[BR]][[BR]] 
     45  //参数// 
     46    tid=; 要查询的主题ID[[BR]] 
     47    callback=; 回调函数名称 [[BR]] 
     48  //说明// 
     49    返回数据类型为JSON [[BR]] 
     50    输出格式样例：{"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]] 
     51* _users.jsp    获取用户数据 
     52    //参数// 
     53    pageType：为user时，返回发帖数排行用户JSON(需要传type参数);为lastpost时，返回最后发帖的用户JSON，否则返回用户的基本信息(需要传userIds)[[BR]] 
     54    days：多少天内的数据(针对typeType=user，默认1天，当天不计)[[BR]] 
     55    pageSize：返回结果数（默认50）[[BR]] 
     56    userIds：用户ID[[BR]] 
     57    faceWidth：用户头像宽度(type=pick时需要传)[[BR]] 
     58    type：“week”为本周贴数，“pick”为全部精华帖,需要返回头像(默认是查精华)[[BR]] 
     59    callback：回调函数[[BR]] 
     60    //说明// 
     61    返货json数据格式，包括用户ID、用户名、昵称、用户个人中心url地址、头像宽度、发主题数、回帖数；接口缓存10小时[[BR]] 
     62    数据格式样例(pageType=user)：[{"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}, 
     63    {"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}][[BR]][[BR]] 
     64* _topicRepliesJson.jsp 根据主题ID，按顺序分页显示回帖(重要）[[BR]][[BR]] 
     65  //参数// 
     66    tid=; 要查询的主题ID[[BR]] 
     67    len=200; 内容显示的字数，过滤掉UBB，默认200字符，如果负数则表示不截取，显示完整的(显示完整内容时会把ubb转换成html)[[BR]] 
     68    pageNo=1; 页数 [[BR]] 
     69    pageSize=10; 每页显示数量 [[BR]] 
     70    callback=; 回调函数名称 [[BR]] 
     71  //说明// 
     72    返回数据类型为JSON[[BR]] 
     73    输出格式样例：({"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]] 
     74* _forumNames.jsp       取版块名称 
     75* _contributionUsers.jsp        论坛获取全站用户贡献值排行榜接口 
     76    //参数// 
     77    aa：显示数据的个数，默认值是10[[BR]] 
     78    type：输出地格式默认是ssi,还有json可选[[BR]] 
     79    callback：回调函数[[BR]] 
     80    //说明// 
     81    输出结果包括用户ID、用户名、昵称、用户个人中心url地址；用json输出；接口缓存10小时[[BR]] 
     82    输出格式样例：[{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名},{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名}][[BR]][[BR]] 
     83* _block_forums.jsp     给果派论坛首页使用（重要） 
     84    //参数// 
     85    fids：版块id以,逗号组成[[BR]] 
     86    callback：回调函数[[BR]] 
     87    //说明// 
     88    根据fids，检索各个板块的今天发帖量、主题总数、回帖总数及最后一个主题的详细，输出格式样例：[{"forumId":1,"count":1,"topics":1,"posts":1},"lastTopicAuthor"{"lastTopicId":1,"lastTopicTitle":1,"lastTopicUrl":1}][[BR]] 
     89* _forumTopics.jsp(it) （重要） 
     90    //参数// 
     91    fid：版块id[[BR]] 
     92    pageNo：页号[[BR]] 
     93    pageSize：分页大小[[BR]] 
     94    callback：回调函数[[BR]] 
     95    //说明// 
     96    根据fid，按发帖时间倒序分页显示Topic，用JSON输出，有分页[[BR]] 
     97* _postCountByHotForums.jsp(it) 
     98   //说明// 
     99   本接口用于显示论坛板块发帖量排行榜，显示昨天的发帖量排行 
     100   功能同_hotForums.jsp,去掉了js显示 
     101* _postsByUser.jsp(it) 
     102    //参数// 
     103    uid：用户id[[BR]] 
     104    type=topic：reply/topic[[BR]] 
     105    count=10：显示条数[[BR]] 
     106    maxLength=240：内容最大长度[[BR]] 
     107    //说明// 
     108    将_myPosts.jsp和_user-posts.jsp整合成该页面，并将返回格式统一为json[[BR]] 
     109* _todayPostCountByForum.jsp(it) （重要） 
     110    //参数// 
     111    fids: 多个fid用逗号分隔[[BR]] 
     112    //说明// 
     113    同_forum-today-post.jsp 
     114* _top_user.jsp(it) 
     115    //参数// 
     116    type: pick/water/topic/post/contribution 
     117    days: 统计多少天之内的 
     118    count=10: 显示条数 
     119    display=json: json/ssi 
     120    callback: 回调函数[[BR]] 
     121    //说明// 
     122    本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。 
     123* _topicReplies.jsp(it) （重要） 
     124    //参数// 
     125    tag: 用于替换的页面元素id 
     126    tid: 主题id,非空 
     127    count=10: 显示条数 
     128    cl=150: 帖子内容显示字数[[BR]] 
     129    //说明// 
     130    论坛主题和其下回复页面接口 
     131* _topicRepliesList.jsp(it)（重要） 
     132    //参数// 
     133    tid: 主题id,非空 
     134    callback: 回调函数[[BR]] 
     135    //说明// 
     136    返回给diy精品用的接口 
     137    返回例: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]] 
     138* _topicReplyCountJson.jsp(it) 
     139    //参数// 
     140    tid: 主题id,非空 
     141    callback: 回调函数[[BR]] 
     142    //说明// 
     143    根据主题ID查找主题回帖数 
     144    返回例:cb({"count":1} ); 
     145* _userList.jsp(it)  
     146    //参数// 
     147    type: pick/water/topic/post/contribution 
     148    days: 统计多少天之内的 
     149    count=10: 显示条数 
     150    display=json: json/ssi 
     151    callback: 回调函数[[BR]] 
     152    //说明// 
     153    本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。 
     154    同_score-member.jsp 
     155== [=#p_intf_special]intf/special == 
     156* _active_user.jsp      得到论坛的活跃好友ID 
     157    //参数// 
     158    size：从数据库里拿出的活跃好友个数[[BR]] 
     159    returnsize：返回的个数[[BR]] 
     160    callback：回调函数[[BR]] 
     161    //说明// 
     162    先从bbs7_user 按lastpostat排序(7天内)，取前size个,最后随机返回returnsize个用户的ID；接口缓存10小时[[BR]] 
     163    输出格式样例：{}[[BR]][[BR]] 
     164* _searchHTML.jsp       通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]][[BR]] 
     165  //参数// 
     166    searchWord=; 关键字[[BR]] 
     167    pageNo=1; 页数[[BR]] 
     168    pageSize=1; 每页显示数量[[BR]] 
     169    searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容[[BR]] 
     170  //说明// 
     171    如果从快速得到的结果为空，则返回最新的一条精华数据[[BR]][[BR]] 
     172* _topics_activity.jsp  现在用于摄影部落chinajoy活动 
     173  //参数// 
     174    fid=; 版块id[[BR]] 
     175    startDate=1; 活动开始时间yyyyMMdd[[BR]] 
     176    containimage=1; 是否只出包含图片的[[BR]] 
     177    type=1; 没用到[[BR]] 
     178    isFilter=; 是否过滤关键字[[BR]] 
     179    titleFilter=; 标题过滤字,需要设置isFilter=1才生效[[BR]] 
     180    orderby=createTime; 排序[[BR]] 
     181    lineSize=3; 一行显示数[[BR]] 
     182    pageNo=1; 页号[[BR]] 
     183    pageSize=9; 每页显示数[[BR]] 
     184    imgWidth=; 图片宽度[[BR]] 
     185    imgHeight=; 图片高度[[BR]] 
     186    css=; 引用样式表路径,有默认[[BR]] 
     187    display=js/json; 显示方式,默认为js[[BR]] 
     188    callback=; 回调函数[[BR]] 
     189  //说明// 
     190    读论坛图片接口修改技术需求[[BR]][[BR]] 
     191* _autoForumAdmin.jsp   论坛根据车系id返回对应版块下的版主、版副、嘉宾接口 
     192    //参数// 
     193    sids：车系ID，多个ID半角逗号分隔(需要在后台板块车系对应插件配置中配置对应关系)[[BR]] 
     194    callback：回调函数[[BR]] 
     195    //说明// 
     196    返回json格式；接口缓存10小时[[BR]] 
     197    输出格式样例：{"forumAdmin1"（版主）:[{"userId":用户ID,"name":用户名,"nickName":昵称}],"forumAdmin2"（版副）:[],"forumAdmin3"（嘉宾）:[],"forumId":板块ID,"sid":车系ID}[[BR]][[BR]] 
     198* _baby_120827.jsp      亲子网论坛获取用户回帖接口 
     199    //参数// 
     200    uid=25315560l：用户ID[[BR]] 
     201    tid=1191267l：主题ID[[BR]] 
     202    maxlength：内容显示最大长度[[BR]] 
     203    callback：回调函数[[BR]] 
     204    //说明// 
     205    考虑性能关系 只在该用户的最新50条回帖里找  如果该用户最新50条回帖都不是该贴内的则不会返回结果；接口缓存720小时[[BR]][[BR]] 
     206* _showCar_cache.jsp vip插件接口的缓存接口 
     207    //说明// 
     208    bbs7已不需要此接口[[BR]][[BR]] 
     209 
     210== [=#p_intf_user]intf/user == 
     211* _topics.jsp   我的主题 （重要） 
     212    //参数// 
     213    userId：用户ID[[BR]] 
     214    pageSize：每页显示多少条（默认50）[[BR]] 
     215    pageNo：第几页[[BR]] 
     216    maxLength：帖子内容显示最大长度[[BR]] 
     217    callback：回调函数[[BR]] 
     218    //说明// 
     219    返回json格式；结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
     220    输出结果样例：{"list":[{"topicId":主题id,"title":主题标题,"message":内容,"url":主题url,"userName":昵称,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,pick:精华,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数(未过滤前)}[[BR]][[BR]] 
     221* _posts.jsp    我的回复 （重要） 
     222    //参数// 
     223    userId：用户ID[[BR]] 
     224    pageSize：每页显示多少条（默认50）[[BR]] 
     225    pageNo：第几页[[BR]] 
     226    maxLength: 回复内容显示最大长度[[BR]] 
     227    callback：回调函数[[BR]] 
     228    //说明// 
     229    返回json格式；结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
     230    输出结果样例：{"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]] 
     231* _picks.jsp    我的精华帖 （重要） 
     232    //参数// 
     233    userId：用户ID[[BR]] 
     234    pageSize：每页显示多少条（默认50）[[BR]] 
     235    pageNo：第几页[[BR]] 
     236    callback：回调函数[[BR]] 
     237    //说明// 
     238    返回json格式；结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
     239    输出结果样例：{"list":[{"title":主题标题,"url":主题url,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}[[BR]][[BR]] 
     240* _favForums.jsp        我收藏的版块 （重要） 
     241    //参数// 
     242    userId：用户ID[[BR]] 
     243    pageSize：每页显示多少条（默认50）[[BR]] 
     244    pageNo：第几页[[BR]] 
     245    callback：回调函数[[BR]] 
     246    //说明// 
     247    返回json格式；没有接口缓存;如果userId不传，则查找当前登录用户的收藏板块[[BR]] 
     248    输出结果样例：{"list":[{"favoriteId":收藏ID,"forumId":板块ID,"name":板块名称,"url":板块地址}],"listCount":记录数}[[BR]][[BR]] 
     249* _favTopics.jsp        我收藏的帖子 （重要） 
     250    //参数// 
     251    userId：用户ID[[BR]] 
     252    pageSize：每页显示多少条（默认50）[[BR]] 
     253    pageNo：第几页[[BR]] 
     254    callback：回调函数[[BR]] 
     255    //说明// 
     256    返回json格式；没有接口缓存[[BR]] 
     257    输出结果样例：{"list":[{"favoriteId":收藏ID,"forumName":板块名称,"forumUrl":板块链接,"isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":最后发表时间,"replyCount":回复数,"title":标题,"topicId":主题ID,"url":主题链接,"viewCount":查看数}],"listCount":记录数}[[BR]][[BR]] 
     258* _idTopics.jsp 根据ID获取主题对象列表[[BR]][[BR]] 
     259  //参数// 
     260    ids=; 要查询的主题ID，多个主题ID用半角逗号分隔[[BR]] 
     261    callback=; 回调函数[[BR]] 
     262  //说明// 
     263    返回数据类型为JSON[[BR]][[BR]] 
     264    输出结果样例：{"list":[{"authorName":"作者名称","authorNickName":"作者昵称","authorUrl":"作者个人中心链接","createAt":"创建时间","forumName":"版块名称","forumUrl":"版块URL","isContainImage":是否包含图片,"isNew":是否新帖,"lastPostAt":"最后回复时间","replyCount":回复数,"title":"标题","topicId":主题ID,"url":"主题URL","viewCount":查看数}],"listCount":列表大小}[[BR]][[BR]] 
     265* _extIds.jsp[[BR]][[BR]] 
     266  //参数// 
     267    userId=;要查询的用户id[[BR]] 
     268    extId=;bbs6中的extId种类,1~6,需要导完旧数据才可查[[BR]] 
     269    dateTrom,dateTo=;yyyy-MM-dd格式日期[[BR]] 
     270    pageNo,pageSize=;分页参数[[BR]] 
     271    callback=;回调函数名[[BR]] 
     272  //说明// 
     273    用于查询兼容bbs6里用户的扩展贴,json格式 
     274* _setVip.jsp    
     275    //参数// 
     276    uid：用户ID[[BR]] 
     277    action：操作(checkVip:检查车主认证状态)[[BR]] 
     278    status：状态(1：通过认证；-1：被驳回；2：提交申请成功；-2：被取消资格)[[BR]] 
     279    reason：原因[[BR]] 
     280    //说明// 
     281    返回JSON格式；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 
     282    输出结果样例：{"desc":"request 描述","status":状态}[[BR]][[BR]] 
     283* _updateSign.jsp  （重要） 
     284    //参数// 
     285    uid：用户ID[[BR]] 
     286    viewSign：是否显示用户签名档，true为显示[[BR]] 
     287    sign：签名档内容，签名档不能超过1200个字[[BR]] 
     288    reason：原因[[BR]] 
     289    //说明// 
     290    异步调用，用于修改用户的签名档（如果用户已有签名档则修改原有的，如果没有则新增签名档）。[[BR]][[BR]] 
     291    输出结果样例：{"desc":"request 描述","status":状态}[[BR]][[BR]] 
     292* _updateMedal.jsp       
     293    //参数// 
     294    uid：用户ID,可以多个，每个直接用逗号分隔[[BR]] 
     295    medalId：勋章ID，可以多个，每个直接用逗号分隔[[BR]] 
     296    action：默认为用户添加勋章，如果action=delete，则取消用户勋章[[BR]] 
     297    reason：原因[[BR]] 
     298    //说明// 
     299    异步调用，用于修改用户的勋章（可以为授勋或取消勋章）。[[BR]][[BR]] 
     300    输出结果样例：{"desc":"描述","status":状态}[[BR]][[BR]] 
     301* _userTopicReplies.jsp  
     302    //参数// 
     303    fid：版块ID[[BR]] 
     304    startdate：统计开始时间，long类型的时间数值[[BR]] 
     305    enddate：统计结束时间，long类型的时间数值[[BR]] 
     306    topicType：话题分类[[BR]] 
     307    //说明// 
     308    统计当前版块下所有用户所发表主帖被回复的数量，按被回复数量排序，返回JSON格式（包括用户ID和被回复数）。[[BR]] 
     309    输出样例：[{"replycounttotal":9,"userid":826717},{"replycounttotal":2,"userid":388},{"replycounttotal":0,"userid":9659992},{"replycounttotal":0,"userid":149561},{"replycounttotal":0,"userid":9673315}][[BR]] 
     310* /intf/user/queryUserReplyCount.do 
     311    //参数//[[BR]] 
     312    fid：版块ID[[BR]] 
     313    uid：用户ID[[BR]] 
     314    from：统计开始时间[[BR]] 
     315    to：统计结束时间[[BR]] 
     316    //说明// 
     317    统计用户在某个版块，某个时间段回复数，返回JSON格式（需要登录后台，没有缓存）。[[BR]] 
     318    输出样例：{"count":1, "uid":903}[[BR]] 
     319 
     320== [=#p_intf]intf ==     
     321* _autosave.jsp 自动保存接口(可能仅供本应用调用,已不再使用) 
     322* _entry.jsp    本接口取消 
     323* _exscore-member.jsp   用于获得N天内的灌水或精华英雄榜 
     324    //参数// 
     325    type：类别(1,2,3,4,5,6分别表示为score1,score2,score3,score4,score5,score6)[[BR]] 
     326    count：多少条（默认10）[[BR]] 
     327    display：返回格式[[BR]] 
     328    //说明// 
     329    返回js/JSON/ssi格式；接口缓存10小时[[BR]] 
     330    输出结果样例：[{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心url,"userId":用户ID,"userName":用户名}][[BR]][[BR]] 
     331* _forum.jsp    查询版块的主题帖[[BR]][[BR]] 
     332  //参数// 
     333    fid=; 版块ID[[BR]] 
     334    count=10; 返回数量[[BR]] 
     335    display=table; 返回主题的页面格式，可选table或ul[[BR]] 
     336    pickStr=false; 是否查询版块精华帖[[BR]] 
     337  //说明// 
     338    返回的页面格式可以是table或ul[[BR]][[BR]] 
     339* _forum_index_auto.jsp 生成汽车论坛"去其他版块"导航内容 
     340    此接口仅由应用内部调用 
     341* _forum-today-post.jsp 游戏网首页接口：id、贴数、板块名称、板块logo （重要） 
     342    //参数//[[BR]] 
     343    forumIds=1,2,3        板块id串[[BR]] 
     344    subf=anystring        是否需要包含子版[[BR]] 
     345    callback              回调函数名[[BR]] 
     346    //说明//[[BR]] 
     347    游戏网首页接口：id、贴数、板块名称、板块logo、描述、子版块的名字和url[[BR]] 
     348    输出结果样例: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"}]}]); 
     349* _forum-yesterday-post.jsp     得到某天的所有版块帖子的统计 （重要） 
     350    //参数//[[BR]] 
     351    filename    8位,以年月日排,如20101001[[BR]] 
     352    //说明//[[BR]] 
     353    此方法是得到某天的所有版块帖子的统计,默认是昨天[[BR]] 
     354    输出版块的id、昨日发帖量、回帖量、PV总数[[BR]] 
     355    输出结果样例(非json)：1,5,5,100\r\n2,5,5,100\r\n 
     356* _hotForums.jsp        显示论坛板块发帖量排行榜 （重要） 
     357* _hotForums2.jsp       显示论坛板块发帖量排行榜   
     358    //参数// 
     359    tag=hot_forums;                      用于替换的标记名称[[BR]] 
     360    snum=10;                             显示的数据条数[[BR]] 
     361    noForums=板块一id,板块二id,...        用于过滤不希望上本排行榜的板块，可以不配置。在后台设置隐藏的板块已经自动过滤掉了。[[BR]] 
     362    callback=;                           回调函数名 
     363* _myPosts.jsp  生成嵌入外部页面的我的发帖列表 
     364    //参数// 
     365    memberId：用户id[[BR]] 
     366    tag：要用来显示内容的element id,这个参数为空则直接用document.write[[BR]] 
     367    target：是回帖（topics）还是主帖（replies），默认显示主帖。[[BR]] 
     368    maxSize：列出帖子最大数目,默认10条,不可以长于50条.[[BR]] 
     369    maxLength：帖子内容最大长度,默认240个英文字符,相当于120个汉字.[[BR]] 
     370    noCss：有这个参数代表不需要生成css.[[BR]] 
     371    //说明// 
     372    本页面生成一段javascript，用于生成嵌入外部页面的我的发帖列表。调用方式是<script src="${ROOT}/_myPosts.jsp"></script>；接口缓存10小时[[BR]][[BR]] 
     373* _onlineUser.jsp       根据版块ID，获取改版块下在线/登录用户数[[BR]][[BR]] 
     374  //参数// 
     375    fid=; 要查询的版块ID 
     376  //说明// 
     377   返回数据类型为html块,缓存时间为900毫秒[[BR]][[BR]] 
     378* _searchForum.jsp      论坛版块搜索接口[[BR]][[BR]] 
     379  //参数// 
     380    q=;关键字[[BR]] 
     381    pageNo=1;[[BR]] 
     382    pageSize=20[[BR]] 
     383    callback=;回调函数名称[[BR]] 
     384  //说明// 
     385   返回数据类型为json,缓存时间为3600毫秒[[BR]][[BR]] 
     386* _photos.jsp   获取指定帖子内的图片[[BR]][[BR]] 
     387  //参数// 
     388    topicId=; 主题ID[[BR]] 
     389    postId=; 帖子ID[[BR]] 
     390    getPos=next/prev;  当没找到时按顺序还是倒序找下一个帖子[[BR]] 
     391    callback=;  回调函数名 
     392  //说明// 
     393    获取指定帖子内的图片,没找到时按参数继续找下一贴,以json格式返回[[BR]][[BR]] 
     394* _pickForums.jsp       显示论坛板块本周精华帖排行榜 
     395  //参数// 
     396    forums,noForums=; 要包含/排除的版块[[BR]] 
     397    topicType=; 帖子话题[[BR]] 
     398    type=f1/f2;  按1级或2级版块分组[[BR]] 
     399    display=; js/json/ssi[[BR]] 
     400    count=; 取前几位的版块[[BR]] 
     401  //说明// 
     402    查询版块一周精华数排行,没有区分pick和expick[[BR]][[BR]] 
     403* _replies_count_json.jsp       获取主题回帖数[[BR]][[BR]] 
     404  //参数// 
     405    tid=; 主题ID[[BR]] 
     406  //说明// 
     407    主题ID可以接受数组形式的参数，以json形式返回[[BR]] 
     408    输出样例：{"count":回帖数}[[BR]] 
     409* _score-member.jsp     获得N天内的灌水或精华英雄榜 （重要） 
     410    //参数// 
     411    type：类别(pick为精华；water为灌水)[[BR]] 
     412    count：多少条（默认10）[[BR]] 
     413    days：统计多少天之内的（当天的不计）[[BR]] 
     414    display：返回格式[[BR]] 
     415    //说明// 
     416    返回js/JSON/ssi格式；接口缓存10小时[[BR]] 
     417    输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}][[BR]][[BR]] 
     418* _score-member2.jsp    获得N天内的灌水或精华英雄榜 
     419    //参数// 
     420    type：类别(pick为精华；water为灌水)[[BR]] 
     421    count：多少条（默认10）[[BR]] 
     422    days：统计多少天之内的（当天的不计）[[BR]] 
     423    display：返回格式[[BR]] 
     424    //说明// 
     425    返回JSON格式；没有接口缓存[[BR]][[BR]] 
     426* _sumPosts.jsp 获取全站的帖子总数和主题总数[[BR]] 
     427    输出结果样例：[{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名},{"score":积分,"url":个人中心链接,"userId":用户ID,"userName":用户名}][[BR]][[BR]] 
     428    //参数// 
     429    callback：回调函数[[BR]] 
     430    //说明// 
     431    返回JSON格式，包括全站主题总数和全站帖子总数[[BR]] 
     432    输出样例：([{"posts":全站帖子总数,"topics":全站主题总数}]);[[BR]] 
     433* _tocensor.jsp 把tocensor表的数据发送到审核平台 （重要） 
     434* _topic.jsp    根据主题ID，获取主题信息[[BR]][[BR]] 
     435  //参数// 
     436    tid=; 要查询的主题ID[[BR]] 
     437    callback=; 回调函数名称[[BR]] 
     438  //说明// 
     439     返回数据类型为JSON[[BR]][[BR]] 
     440* _topicReplies.jsp     论坛主题和其下回复页面[[BR]][[BR]] 
     441  //参数// 
     442    tag=bbs_topicReplies; 用于替换的标记名称[[BR]] 
     443    count=10;             列出回复条数[[BR]] 
     444    topic=;               主题ID，不能为空[[BR]] 
     445    cl=150;               帖子内容显示字数[[BR]] 
     446    display=js;           可选js或json[[BR]] 
     447    callback=;            回调函数，仅返回类型为json时有效[[BR]] 
     448  //说明// 
     449     列出主题下的最新count条回帖，按楼层数逆序排列[[BR]][[BR]] 
     450* _topics.jsp[[BR]][[BR]] 
     451  //参数// 
     452    subsite=false;是否只查单个版块，默认为false[[BR]] 
     453    noForums=;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块[[BR]] 
     454    forums=;版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块[[BR]] 
     455    type=new;查询类型。可填new,hot,pick[[BR]] 
     456    display=ssi;显示方式，支持js,json和ssi[[BR]] 
     457    css=false; 是否使用CSS架构。true表示使用，这时会以DIV方式输出代码[[BR]] 
     458    count=10;列出条数[[BR]] 
     459    messageLength=;帖子内容最大长度,默认没有限制.（目前只有json时生效）[[BR]] 
     460    days=2;从多少天前的数据开始查询，可填任意整数[[BR]] 
     461    pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] 
     462    callback=;当display=json时使用的回调函数名称[[BR]] 
     463  //说明// 
     464     可以查看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]] 
     465* _topics_id.jsp[[BR]][[BR]] 
     466  //参数// 
     467    ids=; 主题ID，多个主题ID用半角逗号分隔[[BR]] 
     468    count=10; 返回数量[[BR]] 
     469    display=; 默认显示主题所有相关信息。若display参数值不为空，则只返回参数值的信息，多个值用半角逗号分隔。例如：display=title,replyCount 则只返回主题的title和replyCount，其余不返回。[[BR]] 
     470    cl=250; 主题帖子内容的显示长度[[BR]] 
     471  //说明// 
     472     返回数据类型为JSON，可指定返回的字段[[BR]] 
     473     输出样例：([{"content":"帖子内容","createAt":"创建时间","forumId":版块ID,"forumName":"版块名称","forumUrl":版块URL","lastPostAt":"最后回复时间","pick":精华类型,"replyCount":回复数,"rewardAmount":悬赏金额,"rewardRemain":悬赏余额,"status":帖子状态,"title":" 
     474标题 
     475","topicId":主题ID,"topicUrl":"主题URL","userId":用户ID,"userName":"用户名称","userUrl":"用户个人中心链接","viewCount":查看数,"isNew":是否新帖,"containImage":是否有图片,"isHot":是否热帖,"isPikc":是否精华帖}]);[[BR]] 
     476* _topics2.jsp  论坛主题列表javascript接口[[BR]][[BR]] 
     477  //参数// 
     478    forum=;版块ID。查找的信息也会包含其子版块[[BR]] 
     479    type=new;查询类型。可填new,hot,pick[[BR]] 
     480    count=10;列出条数[[BR]] 
     481    pickType=;精华类型，默认为精华，可以传入pick1，pick2，pick3，pick4，pick5 以查询其他精华类型[[BR]] 
     482    callback=;回调函数名称[[BR]] 
     483  //说明// 
     484    可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找[[BR]] 
     485    输出样例：([{"createAt":"创建时间","forumId":版块ID,"forumName":"版块名称","forumUrl":"版块URL","lastPostAt":"最后回复时间","rate":查看数比例值,"rateReply":回复数比例值,"replyCount":回复数,"rewardAmount":悬赏金额,"rewardRemain":悬赏余额,"title":" 
     486标题 
     487","topicId":主题ID,"topicUrl":"主题URL","userId":用户ID,"userName":"用户名称","userUrl":"用户个人中心链接","viewCount":查看数}]);[[BR]] 
     488* _topics-css.jsp       论坛主题列表javascript接口[[BR]][[BR]] 
     489  //参数// 
     490    tag=bbs_topics; 用于替换的标记名称[[BR]] 
     491    forum=;版块ID。查找的信息也会包含其子版块[[BR]] 
     492    type=new;查询类型。可填new,hot,pick[[BR]] 
     493    display=js;显示方式，支持js,json和ssi[[BR]] 
     494    count=10;列出条数[[BR]] 
     495    callback=;当display=json时使用的回调函数名称[[BR]] 
     496  //说明// 
     497     可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找[[BR]][[BR]] 
     498* _userExtTopics.jsp  论坛用户发扩展主题数接口 
     499    //参数// 
     500    uid：用户ID[[BR]] 
     501    extId：帖子的扩展ID(1:盖楼帖 2:为活动贴 3:交易帖 4:链接帖 5:一帖多发虚拟帖 6:达人牛帖)[[BR]] 
     502    dateFrom：开始日期[[BR]] 
     503    dateTo：结束日期[[BR]] 
     504    ck：回调函数[[BR]] 
     505    //说明// 
     506    查询用户在一个时间段内的发扩展主题数，未包括已删除的；接口缓存10小时[[BR]] 
     507    输出样例说明：{"count":主题数}[[BR]][[BR]]     
     508* _userTopics.jsp   论坛用户发主题数接口 
     509    //参数// 
     510    uid：用户ID[[BR]] 
     511    postCount：最少回帖数[[BR]] 
     512    dateFrom：开始日期[[BR]] 
     513    dateTo：结束日期[[BR]] 
     514    ck：回调函数[[BR]] 
     515    //说明// 
     516    查询用户在一个时间段内的发扩展主题数和精华数，未包括已删除的；接口缓存10小时[[BR]] 
     517    输出样例说明：{"count":主题数, "picks":精华数}[[BR]][[BR]]        
     518* _picksPeriod.jsp   获取一段时间内精华帖接口 
     519    //参数// 
     520    startdate：开始日期（需要传微秒形式）[[BR]] 
     521    enddate：结束日期（需要传微秒形式）[[BR]] 
     522    fid：板块ID[[BR]] 
     523    pick：1查精华 0查所有[[BR]] 
     524    topicType：话题类型(activity/vote/trade/html)[[BR]] 
     525    //说明// 
     526    获取一段时间内精华帖；接口没有使用缓存[[BR]][[BR]] 
     527* _friends.jsp 
     528    //参数// 
     529    uids：用户id,用半角逗号分隔[[BR]] 
     530    tag：要用来显示内容的element id,这个参数为空则直接用document.write[[BR]] 
     531    //说明// 
     532    (itbbs:似乎只是出一段用户信息的html,跟好友无关,不知道哪里用到) 
     533* _topicAndTops.jsp 
     534    //参数// 
     535    count：列出条数[[BR]] 
     536    forum: 版块id[[BR]] 
     537    pick：1表示只列精华,默认不限[[BR]] 
     538    reply：回复数至少有[[BR]] 
     539    days：只查最近多少天的[[BR]] 
     540    tag：用于替换的标记名称[[BR]] 
     541    top: 置顶帖条数[[BR]] 
     542    callback: 回调函数名[[BR]] 
     543    display: js/ssi/json[[BR]] 
     544    //说明// 
     545    功能大致同intf/common/_topics.jsp,但是是出某一版块带置顶的帖子[[BR]][[BR]] 
     546* prodTopic.jsp 
     547    与_topicAndTops.jsp一模一样 
     548* _forums.jsp 
     549    //参数// 
     550    of=1: 版块id 
     551    showHidden=0: 是否显示隐藏版块 0以外显示 
     552    showRedirect=0: 是否显示有跳转链接的版块 0以外显示 
     553    //说明// 
     554    提供给软件下载，显示版块列表[[BR]][[BR]] 
     555                 
     556 
     557== [=#p_action_user]action/user == 
     558* active.jsp    论坛激活用户接口[[BR]][[BR]] （重要） 
     559  //参数// 
     560    uid：用户ID[[BR]] 
     561    username：用户名[[BR]] 
     562    nickname：昵称[[BR]] 
     563    appCode：应用代码(暂时无用)[[BR]] 
     564  //说明// 
     565     调用机器IP需要在后台配置ScoreClientMachine范围内；如果根据用户ID找不到该用户，则新建一个用户，并激活。[[BR]] 
     566    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     567* actived.jsp   论坛检查用户是否激活接口[[BR]][[BR]] （重要） 
     568  //参数// 
     569    uid：用户ID数组（用户“,”分隔）[[BR]] 
     570  //说明// 
     571     调用机器IP需要在配置ScoreClientMachine范围内；传入用户ID数组，输出未激活的用户ID。[[BR]] 
     572    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     573* admin_forums.jsp      论坛获取用户管理角色接口[[BR]][[BR]] 
     574  //参数// 
     575    uid：用户ID[[BR]] 
     576  //说明// 
     577     用于在帖子页头衔上面显示。[[BR]][[BR]] 
     578* check_favorite.jsp    论坛判断当前登录用户是否收藏了该帖子接口[[BR]][[BR]] （重要） 
     579  //参数// 
     580    tid：主题ID[[BR]] 
     581    fid：板块ID[[BR]] 
     582  //说明// 
     583     如果是收藏了，则返回收藏ID，否则返回-1；如果tid参数不为空，则优先判断是否收藏了改帖子，如果tid为空，fid不为空，才判断是否收藏了该板块；需要用post方式提交[[BR]] 
     584    输出结果样例：0/1[[BR]][[BR]] 
     585* contribution_update.jsp       论坛调用户贡献接口[[BR]][[BR]] 
     586  //参数// 
     587    uid：用户ID[[BR]] 
     588    contribution：需要增加的贡献值[[BR]] 
     589    reason：原因[[BR]] 
     590  //说明// 
     591     需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]] 
     592    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     593* delete_posts.jsp      论坛清除用户发帖接口[[BR]][[BR]] 
     594  //参数// 
     595    uid：用户ID[[BR]] 
     596    reason：原因[[BR]] 
     597  //说明// 
     598     必须使用post方式提交。[[BR]] 
     599    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     600* exscore_update.jsp    论坛调用户扩展积分接口[[BR]][[BR]] 
     601  //参数// 
     602    uid：用户ID[[BR]] 
     603    exscore：需要增加的积分值[[BR]] 
     604    reason：原因[[BR]] 
     605    type：扩展积分[[BR]] 
     606  //说明// 
     607     需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]] 
     608    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     609* favorite.jsp  论坛用户收藏接口[[BR]][[BR]] 
     610  //参数// 
     611    fid：板块ID[[BR]] 
     612    tid：主题ID[[BR]] 
     613  //说明// 
     614     当前登录用户收藏包括板块或主题，收藏成功后会发动态到个人中心，必须使用post方式提交。[[BR]] 
     615    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     616* favorite_delete.jsp   论坛删除当前登录用户收藏接口[[BR]][[BR]] 
     617  //参数// 
     618    id：需要删除的收藏id[[BR]] 
     619  //说明// 
     620     支持批量删除，id用“,”分隔。[[BR]] 
     621    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     622* favorite_forums.jsp   论坛获取当前登录用户收藏板块接口[[BR]][[BR]] 
     623  //参数// 
     624    pageNo：第一页，默认第一页[[BR]] 
     625    pageSize：每页显示多少条，默认10条[[BR]] 
     626  //说明// 
     627    返回json数组格式。[[BR]] 
     628    输出结果样例：{"forumList":[{"favoriteId":收藏ID,"forumAdmins":[{"forumAdminId":版主用户ID,"forumAdminName":版主用户名}],"lastPostAt":最后发表时间,"lastPosterId":最后发表人        ID,"lastPosterNickname":最后发表人名,"name":板块ID,"postCount":回帖数,"todayPostCount":今天回帖数,"topicCount":发帖数,"url":板块链接}],"pageCount":总页数,"pageNo":页码,"pageSize":每页显示数据量,"total":总数据量}[[BR]][[BR]] 
     629* favorite_topics.jsp   论坛获取当前登录用户收藏主题接口[[BR]][[BR]] 
     630  //参数// 
     631    pageNo：第一页，默认第一页[[BR]] 
     632    pageSize：每页显示多少条，默认10条[[BR]] 
     633  //说明// 
     634     返回json数组格式。[[BR]] 
     635    输出结果样例：[{"author":用户名,"authorId":用户ID,"createAt":创建时间,"favoriteId":收藏ID,"lastPostAt":最后发表时间,"name":用户名,"replyCount":回复数,"url":主题链接,"views":查看数}][[BR]][[BR]] 
     636* lock.jsp      论坛锁用户接口[[BR]][[BR]] 
     637  //参数// 
     638    fid：锁单个板块ID[[BR]] 
     639    uid：锁单个用户ID[[BR]] 
     640    fids：批量锁板块ID[[BR]] 
     641    uids：批量锁用户ID[[BR]] 
     642    reason：原因[[BR]] 
     643    expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）[[BR]] 
     644    type：如果是all，则锁全站，否则锁板块[[BR]] 
     645  //说明// 
     646     支持批量锁用户；非管理员角色，默认会发系统消息给用户；需要使用post方式提交。[[BR]] 
     647    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明,"lockId":锁ID，"lockDesc":锁描述}][[BR]][[BR]] 
     648* lock_all.jsp  论坛锁用户接口[[BR]][[BR]] 
     649  //参数// 
     650    uid：锁单个用户ID[[BR]] 
     651    reason：原因[[BR]] 
     652    expiration：锁至日期（如果时间大于2050年则只设到2050年，防止时间太大造成mysql数据库无法正常识别）[[BR]] 
     653  //说明// 
     654     把单个用户锁全站；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 
     655    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     656* medal_update.jsp      论坛更新用户勋章接口[[BR]][[BR]] 
     657  //参数// 
     658    uid：单个用户ID[[BR]] 
     659    reason：原因[[BR]] 
     660    medalId：勋章ID[[BR]] 
     661  //说明// 
     662     如果传入的勋章ID不在用户已有勋章范围内，则新增；如果用户已有的勋章ID不在传入勋章范围内，则删除该勋章。[[BR]] 
     663    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     664* propstr_update.jsp    论坛更新用户自定义头衔接口[[BR]][[BR]] 
     665  //参数// 
     666    uid：用户ID[[BR]] 
     667    reason：原因[[BR]] 
     668    propstr：自定义头衔[[BR]] 
     669  //说明// 
     670    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     671* recent_forums.jsp     论坛获取当前登录用户最近浏览板块接口[[BR]][[BR]] 
     672  //参数// 
     673  //说明// 
     674    根据cookie--"visitedfid"找到用户最近浏览的板块，返回json数组格式[[BR]] 
     675    输出结果样例：[{"url":板块链接,"name":版块名,"topicCount":主题数,"postCount":回帖数,"lastPosterId":最后发表人ID,"lastPosterNickname":最后发表人昵称,"lastPostAt":最后发表时间,"todayPostCount":今天回复数,"forumAdmins":{"forumAdminId"：版主ID,"forumAdminName":版主名称}}][[BR]][[BR]] 
     676* score_update.jsp      论坛调用户积分接口[[BR]][[BR]] 
     677  //参数// 
     678    uid：用户ID[[BR]] 
     679    reason：原因[[BR]] 
     680    score：需要增加的积分值[BR]] 
     681  //说明// 
     682    需要用post方式提交，调整完之后会发送一条系统消息给用户[[BR]] 
     683    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     684* sign_disable.jsp      论坛屏蔽用户签名接口[[BR]][[BR]] 
     685  //参数// 
     686    uid：用户ID[[BR]] 
     687    username：用户名[[BR]] 
     688    uids：多个用户ID[BR]]  
     689    fid：板块ID（用于判断权限）[[BR]] 
     690    reason：原因[[BR]] 
     691  //说明// 
     692    支持批量处理用户签名；需要用post方式提交；屏蔽完之后会发送系统消息[[BR]] 
     693    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     694* sign_enable.jsp       论坛激活用户签名接口[[BR]][[BR]] 
     695  //参数// 
     696    uid：用户ID[[BR]] 
     697    username：用户名[[BR]] 
     698    uids：多个用户ID[BR]]  
     699    fid：板块ID（用于判断权限）[[BR]] 
     700    reason：原因[[BR]] 
     701  //说明// 
     702    支持批量处理用户签名；需要用post方式提交；激活完之后会发送系统消息[[BR]] 
     703    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     704* unlock.jsp    论坛用户解锁接口[[BR]][[BR]] 
     705  //参数// 
     706    lockId：锁ID[[BR]] 
     707    reason：原因[[BR]] 
     708  //说明// 
     709    根据锁ID解锁用户；解锁完之后完之后会发送系统消息[[BR]] 
     710    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     711* unlock_all.jsp        论坛用户解锁（全站）接口[[BR]][[BR]] 
     712  //参数// 
     713    uid：用户ID[[BR]] 
     714    reason：原因[[BR]] 
     715  //说明// 
     716    把单个用户全站解锁；需要使用post方式提交；调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 
     717    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     718* unlockByUserId.jsp    论坛用户解锁接口[[BR]][[BR]] 
     719  //参数// 
     720    uids：用户ID[[BR]] 
     721    reason：原因[[BR]] 
     722  //说明// 
     723    按用户id对用户全站被锁的模块都解锁；支持批量方式；需要post方式提交；解锁完之后完之后会发送系统消息[[BR]] 
     724    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     725* update.jsp    论坛修改用户信息接口[[BR]][[BR]] 
     726  //参数// 
     727    nickname：昵称[[BR]] 
     728    sign：个性签名[[BR]] 
     729    hintMessage：是否暗示消息(?)[[BR]] 
     730    propNum：用户所在城市ID[[BR]] 
     731    propStr：扩展字段[[BR]] 
     732  //说明// 
     733    修改当前登录用户个性签名（自动激活）、扩展字段（如果是汽车网则包括地区ID）、昵称、hintMessage；需要用post方式提交[[BR]] 
     734    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     735* update_contact.jsp    论坛修改用户联系方式接口[[BR]][[BR]] 
     736  //参数// 
     737    uid：用户ID[[BR]] 
     738    contact：联系方式[[BR]] 
     739    reason：原因[[BR]] 
     740  //说明// 
     741    家居网专有(以后可以废弃，改用controller方式)[[BR]][[BR]] 
     742* updateProp.jsp        论坛修改用户信息接口[[BR]][[BR]] 
     743  //参数// 
     744    propNum：用户所在城市ID[[BR]] 
     745    propStr：拥有车型ID;车型名,如没有车型的填写车系ID;车系名[[BR]] 
     746    type: 为0时,更新两个,当为1时,更新propStr,当为2时,更新propNum[[BR]] 
     747  //说明// 
     748    修改当用户扩展字段（如果是汽车网则包括地区ID）；需要用post方式提交[[BR]] 
     749    输出结果样例：[{"status":状态（-1：失败；0：成功）,"desc":说明}][[BR]][[BR]] 
     750* user_json.jsp        论坛获取单个用户信息接口[[BR]][[BR]] 
     751  //参数// 
     752    id：用户ID[[BR]] 
     753    name：账号[[BR]] 
     754    callback: 回调函数[[BR]] 
     755  //说明// 
     756    返回json,信息包括用户ID、账号、昵称、注册时间、积分、所在角色组名[[BR]] 
     757    输出结果样例：{"createAt":创建时间,"groupName":会员组名,"name":用户名,"nickname":昵称,"score":积分,"userId":用户ID}[[BR]][[BR]] 
     758* user_setting_json.jsp        论坛获取单个用户信息接口[[BR]][[BR]] 
     759  //参数// 
     760    uid：用户ID[[BR]] 
     761    name：账号[[BR]] 
     762    callback: 回调函数[[BR]] 
     763  //说明// 
     764    包括用户所有信息，如果不是审核员，还会返回用户管理角色列表。[[BR]] 
     765    输出结果样例：{"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]] 
     766 
     767== [=#p_rest]rest == 
     768* forums.jsp           论坛列表页和发主题接口 （重要）[[BR]][[BR]] 
     769  //参数// 
     770    forumId：板块ID[[BR]] 
     771    title：主题标题[[BR]] 
     772    type：主题类型[[BR]] 
     773    message：内容[[BR]] 
     774    pageNo：第几页[[BR]] 
     775    pageSize：每页显示多少条[[BR]] 
     776  //说明// 
     777    POST:发帖;GET:列表页 [[BR]] 
     778    注:销售配合开始： 2012-11-28至2012-12-04、2012-12-13至2012-12-20 在forum16655版块置顶帖子3431731。 [[BR]][[BR]] 
     779* topics.jsp           论坛帖子页和发回帖接口（重要）[[BR]][[BR]] 
     780  //参数// 
     781    topicId：主题ID[[BR]] 
     782    title：主题标题[[BR]] 
     783    reason：删帖原因[[BR]] 
     784    message：内容[[BR]] 
     785    pageNo：第几页[[BR]] 
     786    pageSize：每页显示多少条[[BR]] 
     787    desc：是否按照楼层降序排序，如果不传该参数，则按升序排[[BR]] 
     788    _method：DELETE和PUT方式需要传该参数（POST方式提交）[[BR]] 
     789  //说明// 
     790    POST:回帖;GET:帖子页;DELETE:删主题;PUT:更新主题。 [[BR]] 
     791  //返回说明// 
     792    DELETE:没有返回内容[[BR]] 
     793    PUT:Location:帖子链接[[BR]] 
     794    POST:Location:帖子链接[[BR]]   
     795    GET{"pageNo":第几页,"pageSize":每页显示条数,"postList":[{"author":{"name":"用户名","nickname":呢称,"userId":用户ID},"createAt":创建时间,"floor":楼层,"message":内容,"postId":回帖ID,"status":状    态}]}[[BR]][[BR]] 
     796* topics-posts.jsp             论坛回帖修改和删除接口（重要） [[BR]][[BR]] 
     797  //参数// 
     798    topicId：主题ID[[BR]] 
     799    postId：回帖ID[[BR]] 
     800    reason：删帖原因[[BR]] 
     801    message：内容[[BR]] 
     802  //说明// 
     803    DELETE:删帖;PUT:更新。 [[BR]] 
     804  //返回说明// 
     805    没有返回内容[[BR]][[BR]] 
     806* topics-hot.jsp               论坛热榜接口 [[BR]][[BR]] 
     807  //参数// 
     808    range：范围，"week"表示查一周热帖排行；"month"表示查一个月热帖排行；不传则查一天热帖排行[[BR]] 
     809    count：获取多少条数据[[BR]] 
     810  //说明// 
     811    返回JSON数组格式。[[BR]][[BR]] 
     812* topline/tree.jsp             论坛获取直接子版块信息接口 [[BR]][[BR]] 
     813  //参数// 
     814    root：板块ID[[BR]] 
     815    callback：回调函数[[BR]] 
     816  //说明// 
     817    [[BR]][[BR]] 
     818 
     819== [=#p_util]util ==  
     820* 119.jsp [[BR]] 
     821  //功能//[[BR]] 
     822 
     823  动态修改spring容器中bean的属性[[BR]] 
     824  //参数// 
     825  bean : spring bean id属性 [[BR]] 
     826 
     827* adminrole.jsp  [[BR]] 
     828  //功能//[[BR]] 
     829 
     830  根据用户ID或版块ID来查找管理员角色 [[BR]] 
     831 
     832 
     833* ai_findpxurl.jsp [[BR]] 
     834  //功能//[[BR]] 
     835 
     836  通过topicId查看pickax的url [[BR]] 
     837 
     838* ai_topic_post.jsp [[BR]] 
     839  //功能//[[BR]] 
     840 
     841  根据topicId来查看主题状态和该主题下的post状态 [[BR]] 
     842 
     843* ai_topic_type_change.jsp [[BR]] 
     844  //功能//[[BR]] 
     845 
     846  修改主题的话题类型 [[BR]] 
     847 
     848* censor.jsp [[BR]] 
     849  //功能//[[BR]] 
     850 
     851  此接口接收的是信息队列发送过来审核平台的信息 [[BR]]  
     852  不再使用,功能转移到controller [[BR]]  
     853 
     854 
     855* d_topic.jsp [[BR]] 
     856  //功能//[[BR]] 
     857 
     858  此页面用于过滤要删除的主题 [[BR]] 
     859 
     860* d.jsp 
     861  //功能//[[BR]] 
     862 
     863  此页面用于过滤要删除的帖子 [[BR]] 
     864 
     865* file.jsp 
     866  //功能// 
     867  此接口供各个服务器上的定时任务，获取计数器数据文件 [[BR]] 
     868  参数如下：[[BR]] 
     869 
     870   method : ls(列出文件名)[[BR]] 
     871 
     872   path : 0 | 15[[BR]] 
     873 
     874   return：如果在path目录下存在数据文件，则打印文件名[[BR]] 
     875 
     876或[[BR]] 
     877 
     878   method : get(获取计数器数据文件)|rm(删除服务器上的计数器数据文件)[[BR]] 
     879 
     880   path : 0 | 15[[BR]] 
     881 
     882   filename: 数据文件，如200811301200[[BR]] 
     883 
     884   return：如果在path目录下存在数据文件，则打印文件内容[[BR]] 
     885 
     886或[[BR]] 
     887 
     888   method : rm(删除服务器上的计数器数据文件)[[BR]] 
     889 
     890   path : 0 | 15[[BR]] 
     891 
     892   filename: 数据文件，如200811301200[[BR]] 
     893 
     894   return：void[[BR]] 
     895 
     896 
     897* import_photo_post.jsp 
     898  //功能//[[BR]] 
     899 
     900  图片分离补录功能,如果某个帖子的图片信息未保存到post_photo表中，可以用该接口来补录 [[BR]] 
     901  //参数//[[BR]] 
     902 
     903  topicId : 主题id,type:topic [[BR]] 
     904  或[[BR]] 
     905  postId : 帖子id,type:post [[BR]] 
     906 
     907* ks_autobbs.jsp 
     908  //功能//[[BR]] 
     909 
     910 从汽车网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] 
     911 
     912* ks_babybbs.jsp 
     913  //功能//[[BR]] 
     914 
     915  从亲子网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] 
     916 
     917* ks_bbs.jsp [[BR]] 
     918  //功能//[[BR]] 
     919 
     920  从电脑网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] 
     921 
     922* ks_gamesbbs.jsp [[BR]] 
     923  //功能//[[BR]] 
     924 
     925  从游戏网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子 [[BR]] 
     926 
     927* ks_ladybbs.jsp [[BR]] 
     928  //功能//[[BR]] 
     929 
     930  从女性网快搜获取包含指定关键字的帖子，且可以在选中后，删除帖子[[BR]] 
     931 
     932* logsetting.jsp 
     933  //功能//[[BR]] 
     934 
     935  设置EnvFilter的log level（开发人员调试用）[[BR]] 
     936 
     937* mc.jsp 
     938  //功能//[[BR]] 
     939 
     940  查看或清除mc缓存[[BR]] 
     941  //参数//[[BR]] 
     942 
     943  action: delete|update|view(默认值)[[BR]] 
     944 
     945  key: mc缓存key[[BR]] 
     946 
     947 
     948* monitor.jsp 
     949  //功能//[[BR]] 
     950 
     951  查看应用运行效率的利器[[BR]] 
     952 
     953* monitor2.jsp 
     954  //功能//[[BR]] 
     955 
     956  查看应用运行效率的利器[[BR]] 
     957 
     958* move_forum_topics.jsp 
     959  //功能//[[BR]] 
     960 
     961  将某个版块的主题移动到指定目标版块 
     962 
     963* online.jsp 
     964  //功能//[[BR]] 
     965 
     966  获取在线用户的uid列表[[BR]] 
     967  //参数// 
     968  cb: 回调函数[[BR]] 
     969  ids: 用户id列表，用逗号分隔[[BR]] 
     970 
     971  //返回//[[BR]] 
     972 
     973  在线用户数组 
     974 
     975* poster.jsp （重要） 
     976  //功能//[[BR]] 
     977 
     978  灌水机接口[[BR]] 
     979 
     980  //参数//[[BR]] 
     981 
     982  uid                   用户ID[[BR]] 
     983  method                有2种方式，发帖与发主题，reply为发帖，默认为发主题[[BR]] 
     984  content               帖子内容[[BR]] 
     985  tid                   主题ID[[BR]] 
     986  fid                   版块ID[[BR]] 
     987  type                  主题类别,String 不验证是否当前版块存在,但最好是存在的,否则没法通过类别过滤[[BR]] 
     988  title                 标题[[BR]] 
     989 
     990  发表回帖需要uid,method=reply,content,tid[[BR]] 
     991  发表主题需要uid,content,fid,type,title[[BR]] 
     992  uid,tid,fid用find方法,如论坛没有,则抛出错误[[BR]] 
     993 
     994  //返回//[[BR]] 
     995 
     996  json数据,status=0时，发帖成功[[BR]] 
     997 
     998* px.jsp[[BR]] 
     999 
     1000  //功能//[[BR]] 
     1001 
     1002  向快聚接口发送主题[[BR]] 
     1003  //参数//[[BR]] 
     1004  tid:主题id 
     1005 
     1006* sync.jsp 
     1007  //功能//[[BR]] 
     1008 
     1009  清除各种常驻内存配置对象的jsp，需要从服务器端发出请求才行[[BR]] 
     1010  合法服务器的列表在appname = System, appkey = servers应用配置项中[[BR]] 
     1011 
     1012* test_ip.jsp[[BR]] 
     1013 
     1014  //功能// 
     1015  本jsp用于测试调用方的服务器ip[[BR]] 
     1016 
     1017 
     1018* text.jsp[[BR]] 
     1019 
     1020  //功能// 
     1021  根据logid查询回帖内容[[BR]] 
     1022 
     1023  //参数// 
     1024  logid: post备份日志id[[BR]] 
     1025 
     1026  date: post_text_history_分表后缀 [[BR]] 
     1027 
     1028 
     1029  //返回//[[BR]] 
     1030 
     1031  回帖内容 
     1032 
     1033* untop_deleted_top.jsp[[BR]] 
     1034 
     1035  //功能//[[BR]] 
     1036 
     1037  取消所有全站置项[[BR]] 
     1038 
     1039 
     1040* upload.jsp 
     1041  //功能// 
     1042  用flash上传图片[[BR]] 
     1043 
     1044 
     1045* user_score.jsp 
     1046  //功能//[[BR]] 
     1047 
     1048  查看用户积分，贡献等信息[[BR]] 
     1049 
     1050  //参数[[BR]] 
     1051 
     1052  callback:回调函数(必须)[[BR]] 
     1053 
     1054  ids:用户id列表，用逗号分隔(必须)[[BR]] 
     1055 
     1056  //返回 
     1057  json格式数组[[BR]] 
     1058ck([{'userId':388,'score':194,'contribution':57,'level':4,'totalLevel':19,'title':'太平洋舰队上等兵','next':200}]);[[BR]] 
     1059 
     1060 
     1061* visited_forum_list.jsp 
     1062  //功能// 
     1063  列举指定的版块的信息 
     1064  //参数// 
     1065  type : 返回的数据的格式(html|json)[[BR]] 
     1066 
     1067  fids : 版块id列表，用'D'分隔[[BR]] 
     1068 
     1069  //返回[[BR]] 
     1070 
     1071  json格式数组[[BR]] 
     1072[{"forumId":4,"name":"一级兄弟版块2","url":"http://localhost.pcauto.com.cn/bbs7/forum-4.html"}] 
     1073 
     1074* /util/roleright.do [[BR]] 
     1075  //功能//[[BR]] 
     1076  查看roleright内存 
     1077 
     1078* /util/userforumrole.do [[BR]] 
     1079  //功能//[[BR]] 
     1080  查看userforumrole内存 
     1081 
     1082* /util/lock.do [[BR]] 
     1083  //功能//[[BR]] 
     1084  查看锁用户，锁IP内存 
     1085 
     1086* /intf/forum/picks.do [[BR]] 
     1087  //功能//[[BR]] 
     1088  查询版块精华接口（查询bbs7_pick表），接口缓存6小时 [[BR]] 
     1089  //参数//[[BR]] 
     1090  fid：板块ID [[BR]] 
     1091  count：获取条数（默认5条）[[BR]] 
     1092  days：多少天内发的帖子（默认2天）[[BR]] 
     1093  orderby：排序条件（默认排序字段是createAt）[[BR]] 
     1094  needContainImage：是否必须包含图片 [[BR]] 
     1095  maxLength:帖子内容最大长度 [[BR]] 
     1096  callback:回调函数 [[BR]] 
     1097  //返回 [[BR]] 
     1098  json格式数组 [[BR]] 
     1099  cb([{"forumId":板块ID,"fourmUrl":板块地址,"topicId":主题ID,"topicUrl":主题地址,"title":主题标题,"type":类型,"message":帖子内容,"createat":创建时间,"lastpostat":最后回复时间,"replyCount":回复数,"viewCount":查看数,"authorName":作者昵称,"authorUrl":作者个人中心地址,"cover":封面,"title":标题}]) 
     1100 
     1101== [=#p_do]do == 
     1102* user/getScore.do 获取论坛用户积分接口[[BR]][[BR]] 
     1103  //参数// 
     1104    uid：用户ID[[BR]] 
     1105    date：时间 格式为yyyy-MM[[BR]] 
     1106    输出结果：返回json格式(包含createat创建时间，amount积分数量，slot积分类型，reason评分原因，createbyid评分的用户id)[[BR]] 
     1107* user/updateNickName.do 从消息队列中接收各网修改昵称的消息[[BR]][[BR]] 
     1108    //参数// 
     1109    msg:格式为{"appName":"common","actionType":"updateNickName","msg":{"accountId":388,"nickName":"fishOK2"}}[[BR]] 
     1110    输出结果：返回json格式[[BR]]