电脑网接口使用情况

[qinhongyuan]

总结和整理一些接口的功能介绍

[qinhongyuan]

---

intf/common/_topics.jsp
使用例子
最新帖子：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=new&count=14&forums=767893&callback=?
回帖最多：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot_month&count=14&forums=767893&callback=?
精华帖：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=pick_all&count=14&forums=767893&callback=?
最多浏览：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot_month&orderby=view&count=14&forums=767893&callback=?
游戏：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot&days=30&subsite=true&count=14&forums=768933&topicType=游戏&callback=?
软件：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot&days=30&subsite=true&count=14&forums=768933&topicType=软件&callback=?

查询单个板块
游戏：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot&days=30&subsite=true&count=10&forums=768933&topicType=游戏&callback=?
软件：
http://itbbs.pconline.com.cn/intf/common/_topics.jsp?display=json&type=hot&days=30&subsite=true&count=10&forums=768933&topicType=软件&callback=?

display=json2显示json数据字符串
display=json显示带callback数据字符串
----

[qinhongyuan]

 intf/common/_users.jsp 获取用户数据
 参数：
 pageType:
 //pageType为user时，返回发帖数排行用户JSON
 //pageType为lastpost时，返回最后发帖的用户JSON
 //pageType不为user时且userIds不为空时，返回用户JSON
 days:多少天内的数据，默认1
 pageSize:返回数据条数，默认50
 userIds:用户id
 faceWidth:头像像数，默认50
 callback：返回函数名
 使用例子:
 http://bbs.pcauto.com.cn/intf/common/_users.jsp?pageType=user&callback=?

[qinhongyuan]

虚拟子版与子版切换用到的接口
http://itbbs.pconline.com.cn/util/subforum.jsp

输入处理版块的父版id
在列表中需要对应一下子版和父版的tableIndex，如果是一样才能操作，否者需要DBA帮忙移帖操作了。。

[qinhongyuan]

某个主帖的回复数据
intf/common/_topicRepliesJson.jsp
	//根据TopicId，按顺序分页显示回帖，用JSON输出，有分页
	//param tid 主题ID
	//param len 内容显示的字数，过滤掉UBB，默认200字符，如果负数则表示不截取，显示完整的(显示完整内容时会把ubb转换成html)
	//param pageNo 页数
	//param pageSize 每页帖子数
	//param callback 返回函数名
例子：
http://itbbs.pconline.com.cn/intf/common/_topicRepliesJson.jsp?tid=15108534&pageSize=5&callback=?

[qinhongyuan]

输入版块ID获取版块名称
intf/common/_forumNames.jsp

参数：
//param fids 版块ID串，逗号隔开
//param callback 返回函数名
例子：
http://itbbs.pconline.com.cn/intf/common/_forumNames.jsp?fids=6&callback=?

[qinhongyuan]

intf/common/_contributionUsers.jsp (电脑网没有该接口)
            /**
             *      功能：
             *           全站用户贡献值排行榜，用ssi或者json列出
             *
             *      参数：
             *            aa       显示数据的个数，默认值是10
             *            type        输出地格式默认是ssi,还有json可选
             *            callback    回调函数
             *
             *       User属性：
             *                 userId      用户Id
             *                 nickName    用户昵称
             *                 name        用户名字
             *                 url         用户链接地址
             *                 faceWidth   用户头像的宽度
             */

例子：
http://bbs.pcauto.com.cn/intf/common/_contributionUsers.jsp?aa=20&type=json&callback=?

[qinhongyuan]

• intf/user目录

  此目录的接口为个人中心专用，提供与用户相关的数据，用JSON返回
  
  1. _topics.jsp 我的主题
  
  2. _posts.jsp 我的回复
  
  3. _picks.jsp 我的精华帖
  
  4. _favForums.jsp 我收藏的版块
  
  5. _favTopics.jsp 我收藏的帖子
  
  6. _idTopics.jsp 根据ID获取主题对象列表
  
  以上方法参数均为userId
  _idTopics.jsp例外，参数为ids
  可以设置回调参数callback