Changes between Version 28 and Version 29 of intf

Timestamp:

02/17/2013 03:23:36 PM (13 years ago)

Author:

kuangjuhuan

Comment:

--

intf

@@ -36 +36 @@
     返回数据类型为JSON[[BR]]
 * _users.jsp    获取用户数据
+    //参数//
+    pageType：为user时，返回发帖数排行用户JSON;为lastpost时，返回最后发帖的用户JSON[[BR]]
+    days：多少天的数据[[BR]]
+    pageSize：每页显示多少条（默认50）[[BR]]
+    userIds：用户ID[[BR]]
+    faceWidth：用户头像宽度[[BR]]
+    type：“week”为本周贴数，“pick”为全部精华帖,需要返回头像[[BR]]
+    callback：回调函数[[BR]]
+    //说明//
+    返货json数据格式，包括用户ID、用户名、昵称、用户个人中心url地址、头像宽度、发主题数、回帖数；接口缓存10小时[[BR]][[BR]]
 * _topicRepliesJson.jsp 根据主题ID，按顺序分页显示回帖[[BR]][[BR]]
   //参数//
@@ -46 +56 @@
     返回数据类型为JSON[[BR]][[BR]]
 * _forumNames.jsp       取版块名称
-* _contributionUsers.jsp        全站用户贡献值排行榜
+* _contributionUsers.jsp        论坛获取全站用户贡献值排行榜接口
+    //参数//
+    aa：显示数据的个数，默认值是10[[BR]]
+    type：输出地格式默认是ssi,还有json可选[[BR]]
+    callback：回调函数[[BR]]
+    //说明//
+    输出结果包括用户ID、用户名、昵称、用户个人中心url地址；用ssi或者json列出；接口缓存10小时[[BR]][[BR]]
 * _block_forums.jsp     给果派论坛首页使用
 
 == intf/special ==
 * _active_user.jsp      得到论坛的活跃好友ID
+    //参数//
+    size：从数据库里拿出的活跃好友个数[[BR]]
+    returnsize：返回的个数[[BR]]
+    callback：回调函数[[BR]]
+    //说明//
+    先从bbs7_user 按lastpostat排序(7天内)，取前size个,最后随机返回returnsize个用户的ID；接口缓存10小时[[BR]][[BR]]
 * _searchHTML.jsp       通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]][[BR]]
   //参数//
@@ -60 +82 @@
     如果从快速得到的结果为空，则返回最新的一条精华数据[[BR]][[BR]]
 * _topics_activity.jsp  2010年某活动统计数据用的接口,接口中时间参数都固定,应该已不再使用
-* _autoForumAdmin.jsp   根据车系id返回对应版块下的版主、版副、嘉宾
+* _autoForumAdmin.jsp   论坛根据车系id返回对应版块下的版主、版副、嘉宾接口
+    //参数//
+    sids：车系ID，多个ID半角逗号分隔(需要在后台板块车系对应插件配置中配置对应关系)[[BR]]
+    callback：回调函数[[BR]]
+    //说明//
+    返回json格式；接口缓存10小时[[BR]][[BR]]
+* _searchHTML.jsp       通过关键字或标题搜索帖子内容,结果从快搜得到[[BR]][[BR]]
 
 == intf/user ==