== 最数码论坛相关接口 == 注：（PS：可以参考 电脑网APP、亲子网APP进行开发）[[BR]] 1．+为本次新增接口，*为本次有改动的接口。[[BR]] 2．接口公共字段说明：status表示状态，message表示操作结果说明。其中status字段值的含义如下：[[BR]] STATUS_ERROR = -1; //错误[[BR]] STATUS_SUCCESS = 0; //成功[[BR]] STATUS_NO_RIGHT = 1; //没有权限[[BR]] STATUS_PARAM_WRONG = 2; //参数错误[[BR]] STATUS_CONTENT_OVERFLOW = 3; //内容超出长度[[BR]] STATUS_EXISTS = 4; //数据已经存在[[BR]] STATUS_NOT_FOUND = 5; //数据查找不到[[BR]] STATUS_NO_LOGIN = 6; //没有登录[[BR]] STATUS_USER_LOCK = 7; //用户被锁[[BR]] STATUS_IP_LOCK = 8; //IP被锁[[BR]] 最数码开发环境地址： [http://dev33.pconline.com.cn/admin.do][[BR]] 最数码测试环境： [http://v15.pconline.com.cn/admin.do][[BR]] 最数码线上环境： [http://piebbs.pconline.com.cn/admin.do][[BR]] ---- '''最数码版块列表页接口'''[[BR]] http://xxx.pconline.com.cn/rest/forums/22 [[BR]] 请求方式：HTTP GET[[BR]] 说明：最后数字是板块ID[[BR]] 缓存：[[BR]] 参数：[[BR]] pageNo: 当前页 默认1[[BR]] pageSize:一页显示几条数据，默认25[[BR]] filter:帖子类型（传递filter=type表示需要所有类型）（filter=pick表示需要精华帖） fval:版块分类（如讨论，晒物，经验，交易）[[BR]] orderby ：按照什么排序（默认是降序）[[BR]] 最新回复时间：replyat[[BR]] 最新发表时间：postat[[BR]] maxLength:标题最大字符串数目[[BR]] showTop：是否展示置顶帖（boolean）,置顶帖单独出，不算在总数中，因为置顶帖不超过10个,显示置顶帖的条件是第一页(pageNo=1)并且fval为空并且showTop为true[[BR]] isCensorFirst ：非必须，看需求是否需要，是否先审后出(true/false)，如果为true并且帖子未审，则title为”该帖子正在审核中”、message为”该帖子正在审核中”[[BR]] 返回(json格式)： {[[BR]] forum: { bbs: 2,[[BR]] forumId: 22,[[BR]] name: "今日聚超值讨论区",[[BR]] parentId: 2,[[BR]] uuid: "123aerhn%32gt45" },[[BR]] pageNo: 1,[[BR]] pageSize: 1,[[BR]] topTopicList: { author: {[[BR]] name: "geniusyys",[[BR]] nickname: "荒木",[[BR]] userFace: "XXX",[[BR]] userId: 20839026[[BR]] },[[BR]] createAt: 1405518128000,[[BR]] floor: 21,[[BR]] formatCreateAt: "2014-07-16 21:42",[[BR]] image: "",[[BR]] lastPostAt: 1413442722000,[[BR]] message: "交易区禁止",[[BR]] replyCount: 20,[[BR]] title: "禁止发多个交易帖子，新东西请在主贴更新",[[BR]] topicId: 104776,[[BR]] uri: "XXX",[[BR]] view: 821[[BR]] }[[BR]] ],[[BR]] topicList: [ { author: { name: "fit10",[[BR]] nickname: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userFace: "XXXX",[[BR]] userId: 826717[[BR]] },[[BR]] createAt: 1463033025000,[[BR]] floor: 1,[[BR]] formatCreateAt: "2016-05-12 14:03",[[BR]] image: "",[[BR]] lastPostAt: 1463033025000,[[BR]] lastPoster: { lastPostAt: "2015-01-22 15:56",[[BR]] name: "qz23180228",[[BR]] nickname: "qz23180228",[[BR]] userId: 23180228[[BR]] },[[BR]] isContainImage: false,[[BR]] message: "按时到啥时候发奖金",[[BR]] replyCount: 0,[[BR]] title: "今天是好日子",[[BR]] topicId: 122451,[[BR]] uri: "XXXX",[[BR]] view: 4[[BR]] }[[BR]] ],[[BR]] total: 23550[[BR]] } 结果说明： topTopicList 这是置顶帖列表[[BR]] topicList 这是主题表列表[[BR]] isContainImage 是否包含图片true或者false[[BR]] 如果是精华帖会多出 isPick:true , flag : ”精”这个字段[[BR]] 如果帖子是本站置顶，则会多出isForumTop ：true字段[[BR]] 如果符合帖子审核通过、作者状态正常并且帖子有图片就会出imgUrls 大小400x的三张图片[[BR]] 如果帖子作者不存在或者帖子作者被锁，则message内容为“用户被封，内容屏蔽”[[BR]] 如果帖子作者不为空，则会显示作者相关信息[[BR]] author: {name: "", nickname: "", userFace: , userId: },[[BR]] 如果最后回复作者不为空，则会出最后回复作者信息[[BR]] lastPoster: {name: "", nickname: "", userFace: , userId: },[[BR]] '''最数码发主帖接口'''[[BR]] http://xxx.pconline.com.cn/rest/forums/22 [[BR]] 请求方式：HTTP POST[[BR]] 说明：最后数字是板块ID[[BR]] 缓存：[[BR]] 参数：[[BR]] title: 标题[[BR]] message:帖子内容[[BR]] type:帖子类型[[BR]] sendMsg: 是否发送消息（false/true）[[BR]] agent:来源 (1代表ios移动端帖子)(2代表Android移动端帖子）或者按照亲子网电脑网那样传递user-agent参数[[BR]] 返回(json格式)：[[BR]] { Location:url, [[BR]] status:0 [[BR]] }[[BR]] 参数说明：[[BR]] Status为0的时候说明发帖成功，否则发帖不成功[[BR]] '''最数码发回帖接口'''[[BR]] http://xxx.pconline.com.cn/rest/topics/122461 [[BR]] 请求方式：HTTP POST[[BR]] 说明：最后数字是帖子ID[[BR]] 缓存：[[BR]] 参数：[[BR]] message:回帖内容[[BR]] replyToId：回复ID[[BR]] sendMsg: 是否发送消息（false/true） agent:来源 (1代表ios移动端帖子)(2代表Android移动端帖子）或者按照亲子网电脑网那样传递user-agent参数[[BR]] 返回(json格式)：[[BR]] { Location:url, [[BR]] status:0 [[BR]] }[[BR]] 参数说明：[[BR]] Status为0的时候说明发回帖成功，否则发回帖不成功[[BR]] '''最数码获取帖子内容信息接口(包括了回帖内容)'''[[BR]] http://xxx.pconline.com.cn/rest/topics/122461 [[BR]] 请求方式：HTTP GET[[BR]] 说明：最后数字是帖子ID[[BR]] 缓存：[[BR]] 参数： pageNo:第几页 [[BR]] authorId：作者ID（有传递表示只看作者回复的内容）[[BR]] desc：是否按楼层倒序，不传递表示按楼层升序[[BR]] agent:来源 (1代表ios移动端帖子)(2代表Android移动端帖子）或者按照亲子网电脑网那样传递user-agent参数[[BR]] isCensorFirst ：非必须，看需求是否需要，是否先审后出(true/false)，如果为true并且帖子未审，则title为”该帖子正在审核中”、message为”该帖子正在审核中”[[BR]] 返回(json格式)：[[BR]] { "curAllImage":[ "p1_1_XXX",[[BR]] "p1_2_XXX"[[BR]] ],[[BR]] pageNo: 1,[[BR]] pageSize: 10,[[BR]] postList: [ { agent: 0,[[BR]] author: { level: "最数码龙头",[[BR]] name: "fit10",[[BR]] nickname: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userFace: "XXX",[[BR]] userId: 826717 },[[BR]] createAt: 1467353045000,[[BR]] floor: 1,[[BR]] message: "这个就是内容",[[BR]] postId: 1873171,[[BR]] status: 0[[BR]] },[[BR]] { agent: 0,[[BR]] author: { level: "最数码龙头",[[BR]] name: "fit10",[[BR]] nickname: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userFace: "XXX",[[BR]] userId: 826717[[BR]] },[[BR]] createAt: 1467353630000,[[BR]] floor: 2,[[BR]] message: "我来回复看看",[[BR]] postId: 1873172,[[BR]] status: 0[[BR]] } ],[[BR]] topic: { author: { level: "最数码龙头",[[BR]] name: "fit10",[[BR]] nickname: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userFace: "XXX",[[BR]] userId: 826717[[BR]] }, bbsId: 66,[[BR]] createAt: 1467353045000,[[BR]] favoriteCount: 0,[[BR]] forumId: 66,[[BR]] forumName: "网络检测",[[BR]] forumUuid: "",[[BR]] lastPostAt: 1467353630000,[[BR]] lastPoster: { name: "fit10",[[BR]] nickname: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userId: 826717[[BR]] },[[BR]] replyCount: 1,[[BR]] title: "第一次发帖",[[BR]] uri: "XXX",[[BR]] view: 5[[BR]] },[[BR]] total: 2 } 参数说明： curAllImage ：帖子图片[[BR]] postList: 表示的回帖内容[[BR]] topic: 表示主题内容[[BR]] 如果帖子作者被锁，则message内容为“用户被封，内容屏蔽”[[BR]] 如果isCensorFirst 为true并且回帖未审，则message为 “该帖子正在审核中，请稍后查看！”[[BR]] 如果帖子是Html帖子，则message 为 “抱歉，暂不支持HTML贴:(”[[BR]] '''最数码获取我的收藏帖子信息接口'''[[BR]] http://xxx.pconline.com.cn/intf/user/_favTopics.jsp [[BR]] 请求方式：GET[[BR]] 说明：获取用户收藏的帖子[[BR]] 缓存：[[BR]] 参数：[[BR]] userId: 用户ID[[BR]] pageNo：当前第几页[[BR]] pageSize：一页显示几条数据（不传递默认5）[[BR]] fid : 版块ID[[BR]] onlyShowForum : 是否只展示fid版块（false/true）[[BR]] callback :回调函数，非必须[[BR]] 返回(json格式)：[[BR]] { list: [ { authorName: "liuyijiabailie",[[BR]] authorNickName: "liuyijiabailie",[[BR]] authorUrl: "XXX",[[BR]] createAt: "15-01-15 21:43",[[BR]] favoriteCount: 1,[[BR]] favoriteId: 20012,[[BR]] forumName: "今日聚超值讨论区",[[BR]] forumUrl: "XXX",[[BR]] image: "XXX",[[BR]] isContainImage: true,[[BR]] isNew: false,[[BR]] lastPostAt: "15-01-22 15:01",[[BR]] lastPosterNickname: "liuyijiabailie",[[BR]] lastPosterUrl: "XXX",[[BR]] replyCount: 4,[[BR]] title: "博朗340S与WF1S",[[BR]] topicId: 121668,[[BR]] url: "XXX",[[BR]] viewCount: 138[[BR]] }, ],[[BR]] listCount: 2 } 参数说明： '''最数码获取我的帖子信息接口'''[[BR]] http://xxx.pconline.com.cn/intf/user/_topics.jsp [[BR]] 请求方式：[[BR]] 说明：获取用户自己的帖子的帖子[[BR]] 缓存：缓存15分钟[[BR]] 参数：[[BR]] userId: 用户ID[[BR]] pageNo：当前第几页[[BR]] pageSize：一页显示几条数据[[BR]] fid : 版块ID[[BR]] orderBy : 根据什么排序(例如createAt)[[BR]] isAsc : 是否升序，false/true[[BR]] maxLength：帖子内容显示最大长度[[BR]] callback :回调函数，非必须[[BR]] 返回(json格式)：[[BR]] { list: [ { censored: 0,[[BR]] fid: 22,[[BR]] floor: 1,[[BR]] forumName: "今日聚超值讨论区",[[BR]] forumUrl: "XXX",[[BR]] image: "",[[BR]] isContainImage: false,[[BR]] isNew: false,[[BR]] lastPostAt: "16-05-12 14:03",[[BR]] message: "按时到啥时候发奖金",[[BR]] pick: 0,[[BR]] pid: 1873161,[[BR]] replyCount: 0,[[BR]] title: "今天是好日子",[[BR]] topicCreateAt: 1463033025000,[[BR]] topicId: 122451,[[BR]] url: "XXX",[[BR]] userName: "太平洋电脑网论坛帖子仅代表作者本人意见",[[BR]] userUrl: "XXX",[[BR]] viewCount: 1[[BR]] }, ],[[BR]] listCount: 10 } 参数说明： censored; //审核状态 0 未审 1 已审[[BR]] pick ; 精华类型 (0代表不是精华) (1代表精华1)( 2代表精华2)[[BR]] '''最数码对帖子进行收藏接口'''[[BR]] http://xxx.pconline.com.cn/favorite.ajax [[BR]] 请求方式：POST[[BR]] 说明：对帖子进行收藏，需要登录[[BR]] 缓存：[[BR]] 参数：[[BR]] fid: 对版块进行收藏，只传递版块ID[[BR]] tid：对帖子进行收藏，只需要传递帖子ID[[BR]] 两个ID只需要根据需求传递一个就可以[[BR]] 返回(json格式)：[[BR]] { status:0, [[BR]] desc:"指定的主题已经添加到收藏夹" [[BR]] } 参数说明： status; 状态码，非0就是不成功 [[BR]] desc ; 结果描述[[BR]] '''最数码检查是否已经收藏帖子或者版块接口'''[[BR]] http://xxx.pconline.com.cn/checkFavorite.ajax [[BR]] 请求方式：POST[[BR]] 说明：检查是否已经收藏帖子或者版块，需要登录[[BR]] 缓存：[[BR]] 参数：[[BR]] tid：对帖子进行收藏，只需要传递帖子ID[[BR]] 返回(json格式)：[[BR]] { status:0, [[BR]] desc:"已经收藏" [[BR]] } 参数说明： status; 状态码，非0就是不成功 [[BR]] desc ; 结果描述[[BR]]