Changes between Version 118 and Version 119 of intf


Ignore:
Timestamp:
01/07/2014 04:25:51 PM (12 years ago)
Author:
dingjianyong
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • intf

    v118 v119  
    1212 
    1313== [=#p_intf_common]intf/common == 
    14 * _topics.jsp   论坛主题列表接口[[BR]][[BR]] 
     14* _topics.jsp   论坛主题列表接口(重要)[[BR]][[BR]] 
    1515  //参数// 
    1616    subsite=false;是否只查单个版块,默认为false。[[BR]] 
     
    6262    数据格式样例(pageType=user):[{"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}, 
    6363    {"face":头像url地址,"name":用户名,"nickName":昵称,"postCount":回帖数,"topicCount":发帖数,"url":个人中心url,"userId":用户ID}][[BR]][[BR]] 
    64 * _topicRepliesJson.jsp 根据主题ID,按顺序分页显示回帖[[BR]][[BR]] 
     64* _topicRepliesJson.jsp 根据主题ID,按顺序分页显示回帖(重要)[[BR]][[BR]] 
    6565  //参数// 
    6666    tid=; 要查询的主题ID[[BR]] 
     
    8181    输出结果包括用户ID、用户名、昵称、用户个人中心url地址;用json输出;接口缓存10小时[[BR]] 
    8282    输出格式样例:[{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名},{"name":用户名,"nickName":呢称,"url":个人中心url,"userId":用户名}][[BR]][[BR]] 
    83 * _block_forums.jsp     给果派论坛首页使用 
    84 * _forumTopics.jsp(it) 
     83* _block_forums.jsp     给果派论坛首页使用(重要) 
     84* _forumTopics.jsp(it) (重要) 
    8585    //参数// 
    8686    fid:版块id[[BR]] 
     
    102102    //说明// 
    103103    将_myPosts.jsp和_user-posts.jsp整合成该页面,并将返回格式统一为json[[BR]] 
    104 * _todayPostCountByForum.jsp(it) 
     104* _todayPostCountByForum.jsp(it) (重要) 
    105105    //参数// 
    106106    fids: 多个fid用逗号分隔[[BR]] 
     
    116116    //说明// 
    117117    本接口用于获得N天内的灌水、精华、主题、帖子、贡献分的英雄榜。 
    118 * _topicReplies.jsp(it) 
     118* _topicReplies.jsp(it) (重要) 
    119119    //参数// 
    120120    tag: 用于替换的页面元素id 
     
    124124    //说明// 
    125125    论坛主题和其下回复页面接口 
    126 * _topicRepliesList.jsp(it) 
     126* _topicRepliesList.jsp(it)(重要) 
    127127    //参数// 
    128128    tid: 主题id,非空 
     
    138138    根据主题ID查找主题回帖数 
    139139    返回例:cb({"count":1} ); 
    140 * _userList.jsp(it) 
     140* _userList.jsp(it)  
    141141    //参数// 
    142142    type: pick/water/topic/post/contribution 
     
    204204 
    205205== [=#p_intf_user]intf/user == 
    206 * _topics.jsp   我的主题 
     206* _topics.jsp   我的主题 (重要) 
    207207    //参数// 
    208208    userId:用户ID[[BR]] 
     
    214214    返回json格式;结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
    215215    输出结果样例:{"list":[{"topicId":主题id,"title":主题标题,"message":内容,"url":主题url,"userName":昵称,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,pick:精华,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数(未过滤前)}[[BR]][[BR]] 
    216 * _posts.jsp    我的回复 
     216* _posts.jsp    我的回复 (重要) 
    217217    //参数// 
    218218    userId:用户ID[[BR]] 
     
    224224    返回json格式;结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
    225225    输出结果样例:{"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]] 
    226 * _picks.jsp    我的精华帖 
     226* _picks.jsp    我的精华帖 (重要) 
    227227    //参数// 
    228228    userId:用户ID[[BR]] 
     
    233233    返回json格式;结果会过滤已删除及未审核;接口缓存10小时[[BR]] 
    234234    输出结果样例:{"list":[{"title":主题标题,"url":主题url,"userName":用户名,"userUrl":个人中心url,"replyCount":回复数,"viewCount":查看数,"isNew":是否新帖,"isContainImage":是否包含秃瓢,"lastPostAt":最后发表时间,"forumName":论坛名称,"forumUrl":论坛地址,"lastPosterNickame":最后发表人昵称,"lastPostUrl":最后发表人个人中心url}],"listCount":结果数}[[BR]][[BR]] 
    235 * _favForums.jsp        我收藏的版块 
     235* _favForums.jsp        我收藏的版块 (重要) 
    236236    //参数// 
    237237    userId:用户ID[[BR]] 
     
    242242    返回json格式;没有接口缓存;如果userId不传,则查找当前登录用户的收藏板块[[BR]] 
    243243    输出结果样例:{"list":[{"favoriteId":收藏ID,"forumId":板块ID,"name":板块名称,"url":板块地址}],"listCount":记录数}[[BR]][[BR]] 
    244 * _favTopics.jsp        我收藏的帖子 
     244* _favTopics.jsp        我收藏的帖子 (重要) 
    245245    //参数// 
    246246    userId:用户ID[[BR]] 
     
    276276    返回JSON格式;需要使用post方式提交;调用机器IP需要在后台配置ScoreClientMachine范围内。[[BR]] 
    277277    输出结果样例:{"desc":"request 描述","status":状态}[[BR]][[BR]] 
    278 * _updateSign.jsp        
     278* _updateSign.jsp  (重要) 
    279279    //参数// 
    280280    uid:用户ID[[BR]] 
     
    334334* _forum_index_auto.jsp 生成汽车论坛"去其他版块"导航内容 
    335335    此接口仅由应用内部调用 
    336 * _forum-today-post.jsp 游戏网首页接口:id、贴数、板块名称、板块logo 
     336* _forum-today-post.jsp 游戏网首页接口:id、贴数、板块名称、板块logo (重要) 
    337337    //参数//[[BR]] 
    338338    forumIds=1,2,3        板块id串[[BR]] 
     
    342342    游戏网首页接口:id、贴数、板块名称、板块logo、描述、子版块的名字和url[[BR]] 
    343343    输出结果样例: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"}]}]); 
    344 * _forum-yesterday-post.jsp     得到某天的所有版块帖子的统计 
     344* _forum-yesterday-post.jsp     得到某天的所有版块帖子的统计 (重要) 
    345345    //参数//[[BR]] 
    346346    filename    8位,以年月日排,如20101001[[BR]] 
     
    349349    输出版块的id、昨日发帖量、回帖量、PV总数[[BR]] 
    350350    输出结果样例(非json):1,5,5,100\r\n2,5,5,100\r\n 
    351 * _hotForums.jsp        显示论坛板块发帖量排行榜 
    352 * _hotForums2.jsp       显示论坛板块发帖量排行榜 
     351* _hotForums.jsp        显示论坛板块发帖量排行榜 (重要) 
     352* _hotForums2.jsp       显示论坛板块发帖量排行榜   
    353353    //参数// 
    354354    tag=hot_forums;                      用于替换的标记名称[[BR]] 
     
    402402    主题ID可以接受数组形式的参数,以json形式返回[[BR]] 
    403403    输出样例:{"count":回帖数}[[BR]] 
    404 * _score-member.jsp     获得N天内的灌水或精华英雄榜 
     404* _score-member.jsp     获得N天内的灌水或精华英雄榜 (重要) 
    405405    //参数// 
    406406    type:类别(pick为精华;water为灌水)[[BR]] 
     
    426426    返回JSON格式,包括全站主题总数和全站帖子总数[[BR]] 
    427427    输出样例:([{"posts":全站帖子总数,"topics":全站主题总数}]);[[BR]] 
    428 * _tocensor.jsp 把tocensor表的数据发送到审核平台 
     428* _tocensor.jsp 把tocensor表的数据发送到审核平台 (重要) 
    429429* _topic.jsp    根据主题ID,获取主题信息[[BR]][[BR]] 
    430430  //参数// 
     
    551551 
    552552== [=#p_action_user]action/user == 
    553 * active.jsp    论坛激活用户接口[[BR]][[BR]] 
     553* active.jsp    论坛激活用户接口[[BR]][[BR]] (重要) 
    554554  //参数// 
    555555    uid:用户ID[[BR]] 
     
    560560     调用机器IP需要在后台配置ScoreClientMachine范围内;如果根据用户ID找不到该用户,则新建一个用户,并激活。[[BR]] 
    561561    输出结果样例:[{"status":状态(-1:失败;0:成功),"desc":说明}][[BR]][[BR]] 
    562 * actived.jsp   论坛检查用户是否激活接口[[BR]][[BR]] 
     562* actived.jsp   论坛检查用户是否激活接口[[BR]][[BR]] (重要) 
    563563  //参数// 
    564564    uid:用户ID数组(用户“,”分隔)[[BR]] 
     
    571571  //说明// 
    572572     用于在帖子页头衔上面显示。[[BR]][[BR]] 
    573 * check_favorite.jsp    论坛判断当前登录用户是否收藏了该帖子接口[[BR]][[BR]] 
     573* check_favorite.jsp    论坛判断当前登录用户是否收藏了该帖子接口[[BR]][[BR]] (重要) 
    574574  //参数// 
    575575    tid:主题ID[[BR]] 
     
    761761 
    762762== [=#p_rest]rest == 
    763 * forums.jsp           论坛列表页和发主题接口 [[BR]][[BR]] 
     763* forums.jsp           论坛列表页和发主题接口 (重要)[[BR]][[BR]] 
    764764  //参数// 
    765765    forumId:板块ID[[BR]] 
     
    772772    POST:发帖;GET:列表页 [[BR]] 
    773773    注:销售配合开始: 2012-11-28至2012-12-04、2012-12-13至2012-12-20 在forum16655版块置顶帖子3431731。 [[BR]][[BR]] 
    774 * topics.jsp           论坛帖子页和发回帖接口[[BR]][[BR]] 
     774* topics.jsp           论坛帖子页和发回帖接口(重要)[[BR]][[BR]] 
    775775  //参数// 
    776776    topicId:主题ID[[BR]] 
     
    789789    POST:Location:帖子链接[[BR]]   
    790790    GET{"pageNo":第几页,"pageSize":每页显示条数,"postList":[{"author":{"name":"用户名","nickname":呢称,"userId":用户ID},"createAt":创建时间,"floor":楼层,"message":内容,"postId":回帖ID,"status":状    态}]}[[BR]][[BR]] 
    791 * topics-posts.jsp             论坛回帖修改和删除接口 [[BR]][[BR]] 
     791* topics-posts.jsp             论坛回帖修改和删除接口(重要) [[BR]][[BR]] 
    792792  //参数// 
    793793    topicId:主题ID[[BR]] 
     
    968968  在线用户数组 
    969969 
    970 * poster.jsp 
     970* poster.jsp (重要) 
    971971  //功能//[[BR]] 
    972972