[[TOC]] = 家居杂志iPhone3.4.0接口文档 = >环境说明： [http://trac.pc.com.cn/mobile/pototype/pchouse-mag/3.4.0/v4/ "产品文档"][[BR]] [ "设计稿地址"][[BR]] [http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.4.0-protocol "终端页协议"][[BR]] == 1.圈子 == ---------- === 1.1精选帖子列表 === mrobot：/selectedTopic.xsp [[BR]] 虚拟币系统：/selectedTopicIds.jsp[[BR]] 论坛系统：[[BR]] 论坛系统可参考：[http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.3.0#a3.2根据帖子id批量获取帖子详情 "根据帖子id批量获取帖子详情"] **说明** > 获取精选帖子列表数据，最多30条精选帖子，每页10条，最多3页。[[BR]] > 帖子数据保存在论坛系统，但精选帖子的id保存在虚拟币系统，所以需要mrobot端先从虚拟币系统获取所有精选帖子的id，再根据分页页数带上对应的帖子id到论坛系统查询帖子数据。 **缓存时间** >无缓存 **提交方式** > GET **是否登录** > 否 **数据来源** >虚拟币系统[[BR]] >论坛系统 **参数** mrobot： ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= 页数 =|| ||pageSize||页面大小||int||10||是||= 每页大小 =|| 虚拟币系统： ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 论坛系统： ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||topicIds||帖子id||string|| "" ||是||= 多个帖子的id，以逗号分隔 =|| **返回** [[BR]]mrobot： {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 10, "total": 30, "data":[{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2, "favorCount":3, "collectCount":5, "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }, ... ] } }}} 虚拟币系统： {{{#!java { "status":0, "msg":"请求成功", "data":["1","2","3",...,"30"] } }}} 论坛系统： {{{#!java [{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2, "favorCount":3, "collectCount":5, "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }, ... ] }}} **返回参数说明** [[BR]]mrobot： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 精选帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| ||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数 =|| ||= tag =||= 帖子对应的标签列表 =||= =||= =|| 虚拟币系统： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 精选帖子id列表 =||= =||= =|| 论坛系统： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= tag =||= 帖子对应的标签列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| ||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数 =|| === 1.2帖子列表（发现、标签、个人主页） === mrobot：/discoveryTopic.xsp [[BR]] 论坛系统： [[BR]] **说明** > 当只传了分页参数，论坛返回所有帖子列表。（发现帖子列表）[[BR]] > 当传了分页参数和标签id，论坛返回该标签下所有帖子列表。（标签帖子列表）[[BR]] > 当传了分页参数和用户id，论坛返回该用户下所有帖子列表。（个人主页帖子列表）[[BR]] > 如果同时存在标签id和用户id，暂定返回错误信息：参数有误 > 分页默认一页20条 **缓存时间** >无缓存 **提交方式** > GET **是否登录** > 否 **数据来源** >论坛系统 **参数** mrobot、论坛系统： ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= 页数 =|| ||pageSize||页面大小||int||20||是||= 每页大小 =|| ||tagId||标签id||int|| ||否||= 单个标签id =|| ||uid||用户id||int|| ||否||= 单个用户id =|| **返回** [[BR]]mrobot： {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 163, "data":[{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2, "favorCount":3, "collectCount":5, "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }, ... ] } }}} 论坛系统： [{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2, "favorCount":3, "collectCount":5, "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }] **返回参数说明** [[BR]]mrobot： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| ||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数 =|| 论坛系统： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| ||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数 =|| [[BR]] === 1.3帖子终端页（修改） === mrobot：http://mrobot.pchouse.com.cn/v3/bbs/topics? [[BR]] 论坛系统： [[BR]] 制作地址：[[BR]] **说明** > 修改帖子终端页接口：主贴下的回帖不再需要分页，直接全部返回，也不需要只看楼主了[[BR]] > 页面需要提供js方法给App端实现点赞和取消点赞的页面动效，以及收藏和取消收藏的页面动效 > **缓存时间** >无缓存 **提交方式** > GET **是否登录** > 否 **数据来源** >论坛系统 **参数** mrobot、论坛系统： ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| || topicId ||帖子id||int|| ||是||= topicId id =|| **返回** [[BR]]mrobot： {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 163, "data":[{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2,, "favorCount":3, "collectCount":5， "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }, ... ] } }}} 论坛系统： [{ "category": "原创", "censor": 1, "coverUrl": "http://img.pchouse.com.cn/images/upload/upc/tx/housebbs6/1511/25/c0/15666999_1448389297447_1024x1024house.jpg", "createAt": "2015-11-25 02:21:41", "floor": 1, "imgUrls": [], "lastPostAt": "2015-11-25 02:21:41", "message": "", "pick": 0, "replyCount": 0, "status": 0, "title": "这灯好看吧", "uid": 40858440, "userFace": "http://i1.3conline.com/images/upload/upc/face/40/85/84/40/40858440_50x50", "userName": "mb40858440", "authorName": "mb40858440", "forumId": 105, "isContainImage": true, "topicId": 1103978, "topicUrl": "http://v26.pchouse.com.cn/topic-1103978.html", "viewCount": 2, "tag":[ {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},... ] }] **返回参数说明** [[BR]]mrobot： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| 论坛系统： ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =|| [[BR]]