= 接口列表 = == 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]] 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]] * _topic.jsp 根据主题ID，获取主题信息[[BR]][[BR]] //参数// tid=; 要查询的主题ID[[BR]] callback=; 回调函数名称 [[BR]] //说明// 返回数据类型为JSON[[BR]] * _users.jsp 获取用户数据 * _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]][[BR]] * _forumNames.jsp 取版块名称 * _contributionUsers.jsp 全站用户贡献值排行榜 * _block_forums.jsp 给果派论坛首页使用 == intf/special == * _active_user.jsp 得到论坛的活跃好友ID * _searchHTML.jsp 通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]][[BR]] //参数// searchWord=; 关键字[[BR]] pageNo=1; 页数[[BR]] pageSize=1; 每页显示数量[[BR]] searchScope=1; 查找的范围,1为标题或内容,2为标题,3为内容[[BR]] //说明// 如果从快速得到的结果为空，则返回最新的一条精华数据[[BR]][[BR]] * _topics_activity.jsp 读论坛图片接口 * _autoForumAdmin.jsp 根据车系id返回对应版块下的版主、版副、嘉宾 == intf/user == * _topics.jsp 我的主题 * _posts.jsp 我的回复 * _picks.jsp 我的精华帖 * _favForums.jsp 我收藏的版块 * _favTopics.jsp 我收藏的帖子 * _idTopics.jsp 根据ID获取主题对象列表[[BR]][[BR]] //参数// ids=; 要查询的主题ID，多个主题ID用半角逗号分隔[[BR]] callback=; 回调函数[[BR]] //说明// 返回数据类型为JSON[[BR]][[BR]] * _extIds.jsp * _setVip.jsp == intf == * _autosave.jsp * _entry.jsp 本接口取消 * _exscore-member.jsp 用于获得N天内的灌水或精华英雄榜 * _forum.jsp 查询版块的主题帖[[BR]][[BR]] //参数// fid=; 版块ID[[BR]] count=10; 返回数量[[BR]] display=table; 返回主题的页面格式，可选table或ul[[BR]] pickStr=false; 是否查询版块精华帖[[BR]] //说明// 返回的页面格式可以是table或ul[[BR]][[BR]] * _forum_index_auto.jsp 生成汽车论坛的论坛地图页 * _forum-today-post.jsp 游戏网首页接口：id、贴数、板块名称、板块logo * _forum-yesterday-post.jsp 得到某天的所有版块帖子的统计 * _hotForums.jsp 显示论坛板块发帖量排行榜 * _hotForums2.jsp 显示论坛板块发帖量排行榜 * _myPosts.jsp 生成嵌入外部页面的我的发帖列表 * _photos.jsp 获取指定帖子内的图片[[BR]][[BR]] //参数// tid=; 主题ID[[BR]] pid=; 帖子ID[[BR]] getPos=next/prev; 当没找到时按顺序还是倒序找下一个帖子 //说明// 获取指定帖子内的图片,没找到时按参数继续找下一贴,以json格式返回[[BR]][[BR]] * _pickForums.jsp 显示论坛板块本周精华帖排行榜 * _replies_count_json.jsp 获取主题回帖数[[BR]][[BR]] //参数// tid=; 主题ID[[BR]] //说明// 主题ID可以接受数组形式的参数，以json形式返回[[BR]][[BR]] * _score-member.jsp 获得N天内的灌水或精华英雄榜 * _score-member2.jsp 获得N天内的灌水或精华英雄榜 * _sumPosts.jsp 获取全站的帖子总数和主题总数 * _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]] 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]][[BR]] * _topics2.jsp 论坛主题列表javascript接口[[BR]][[BR]] //参数// forum=;版块ID。查找的信息也会包含其子版块[[BR]] type=new;查询类型。可填new,hot,pick[[BR]] count=10;列出条数[[BR]] callback=;当display=json时使用的回调函数名称[[BR]] //说明// 可以查看3种形式的主题列表，最新，最热，精华。从topic冗余表查找[[BR]][[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 * _userTopics.jsp == action/user == * active.jsp 论坛激活用户接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] username：用户名[[BR]] nickname：昵称[[BR]] appCode：应用代码(暂时无用)[[BR]] //说明// 调用机器IP需要在后台配置ScoreClientMachine范围内；如果根据用户ID找不到该用户，则新建一个用户，并激活。[[BR]][[BR]] * actived.jsp 论坛检查用户是否激活接口[[BR]][[BR]] //参数// uid：用户ID数组（用户“,”分隔）[[BR]] //说明// 调用机器IP需要在配置ScoreClientMachine范围内；传入用户ID数组，输出未激活的用户ID。[[BR]][[BR]] * admin_forums.jsp 论坛获取用户管理角色接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] //说明// 用于在帖子页头衔上面显示。[[BR]][[BR]] * check_favorite.jsp 论坛判断当前登录用户是否收藏了该帖子接口[[BR]][[BR]] //参数// tid：主题ID[[BR]] //说明// 如果是收藏了，则返回0，否则返回-1；需要用post方式提交。[[BR]][[BR]] * contribution_update.jsp 论坛调用户贡献接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] contribution：需要增加的贡献值[[BR]] reason：原因[[BR]] //说明// 需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]][[BR]] * delete_post.jsp 论坛清除用户发帖接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] reason：原因[[BR]] //说明// 必须使用post方式提交。[[BR]][[BR]] * exscore_update.jsp 论坛调用户扩展积分接口[[BR]][[BR]] //参数// uid：用户ID[[BR]] exscore：需要增加的积分值[[BR]] reason：原因[[BR]] type：扩展积分[[BR]] //说明// 需要用post方式提交，调整完之后会发送一条系统消息给用户。[[BR]][[BR]] * favorite.jsp 论坛用户收藏接口[[BR]][[BR]] //参数// fid：板块ID[[BR]] tid：主题ID[[BR]] //说明// 当前登录用户收藏包括板块或主题，收藏成功后会发动态到个人中心，必须使用post方式提交。[[BR]][[BR]] * favorite_delete.jsp 论坛删除当前登录用户收藏接口[[BR]][[BR]] //参数// fid：板块ID[[BR]] tid：主题ID[[BR]] //说明// 支持批量删除，id用户“,”分隔。[[BR]][[BR]] * favorite_forums.jsp 论坛获取当前登录用户收藏板块接口[[BR]][[BR]] //参数// pageNo：第一页，默认第一页[[BR]] pageSize：每页显示多少条，默认10条[[BR]] //说明// 返回json数组格式。[[BR]][[BR]] * user_setting_json.jsp * user_json.jsp * recent_forums.jsp