[[TOC]]
= 家居杂志iPhone3.4.0接口文档 =
>环境说明：
     
     [http://trac.pc.com.cn/mobile/pototype/pchouse-mag/3.4.0/v4/ "产品文档"][[BR]]
     [http://192.168.50.192/2016/PChouse/5.27/index.htm "设计稿地址"][[BR]]
     [http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.4.0-protocol "终端页协议"][[BR]]

     [http://rdtrac.pc.com.cn/bbs/wiki/intf "论坛接口"][[BR]]
     mrobot开发环境：dev40.pchoust.....或者代理192.168.74.80 1080


== 1.圈子 ==
----------
=== 1.1精选帖子列表 (mrobot已完成，请链接开发机测试) ===
mrobot：http://mrobot.pchouse.com.cn/s/magazine/nocache/pchouse/bbs/selectedTopic.xsp [[BR]]
虚拟币系统：[[BR]]
> 开发环境：http://dev19.pchouse.com.cn:9090/intf/selectedTopicIds.jsp [[BR]]
> 测试环境：[[BR]]
论坛系统：[[BR]]
论坛系统可参考：[http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.3.0#a3.2根据帖子id批量获取帖子详情 "根据帖子id批量获取帖子详情"]

**说明**
> 获取精选帖子列表数据，最多30条精选帖子，每页10条，最多3页。[[BR]]
> 帖子数据保存在论坛系统，但精选帖子的id、以及帖子是否置顶的信息保存在虚拟币系统。 [[BR]]
> 所以需要mrobot端先从虚拟币系统获取所有精选帖子的信息后，再根据分页页数带上对应的帖子id到论坛系统查询帖子数据。[[BR]]
> mrobot注意：虚拟币系统除了提供精选id外还会提供该帖子是否置顶，这个置顶属性需要一起返回给app。

**缓存时间**
> mrobot无缓存，虚拟币无缓存，论坛15分钟

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 虚拟币系统[[BR]]
> 论坛系统

**参数**
> mrobot：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||pageNo||页数||int||1||是||= 页数  =||
||pageSize||页面大小||int||10||是||= 每页大小  =||

> 虚拟币系统：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||

> 论坛系统：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||topicIds||帖子id||string|| "" ||是||= 多个帖子的id，以逗号分隔  =||

**返回**
> 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,
        "isTop":1,//是否置顶
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },
    ...
  ]
}
}}}

> 虚拟币系统：
{{{#!java
{
  "status":0,
  "msg":"请求成功",
  "data":[
      {
        "id":"1",
        "isTop":1
      },{
        "id":"2",
        "isTop":1
      },,...
  ]
}
}}}

> 论坛系统：
{{{#!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":"衣柜"},...
        ]
    },
    ...
  ]
}}}

**返回参数说明**
> mrobot：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 精选帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||
||= tag =||= 帖子对应的标签列表 =||= isTop  =||= 是否精选置顶，0：不是 ，1：是  =||

> 虚拟币系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 精选帖子id列表 =||= isTop =||= 是否精选置顶，0：不是 ，1：是 =||

> 论坛系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= tag =||= 帖子对应的标签列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||

[[BR]]
[[BR]]

=== 1.2发现帖子列表 ===
mrobot：/discoveryTopicList.xsp [[BR]]
论坛系统： http://bbs.pchouse.com.cn/rest/forums.jsp（修改） [[BR]]

**说明**
> 论坛返回发现帖子列表。（发现帖子列表）[[BR]]
> 分页默认一页20条

**缓存时间**
>无缓存

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 论坛系统

**参数**
> mrobot：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||fid||板块id||int|| 185 ||是||= 板块id，对应这次新增的板块，一般来说是185  =||
||pageNo||页数||int||1||是||= 页数  =||
||pageSize||页面大小||int||20||是||= 每页大小  =||

>论坛系统的参数请参照论坛同事给出的文档。

**返回**
> mrobot：
{{{#!java
{
    "pageNo": 1,
    "pageSize": 1,
    "total": 21090,
    "data": [
        {
            "author": {
                "name": "fish",
                "nickname": "fish",
                "userFace": "http://i1.3conline.com/images/upload/upc/face/38/8/388_50x50",
                "userId": 388
            },
            "createAt": "2016-06-08 17:54:44",
            "favorCount": 0,
            "floor": 1,
            "formatCreateAt": "16-06-08 17:54",
            "image": "",
            "message": "dfjskjfdk ",
            "replyCount": 0,
            "title": "fish lai fatie ",
            "topicId": 1104473,
            "uri": "http://v26.pchouse.com.cn/topic-1104473.html",
            "view": 1
        }
    ],
    "status": 0,
    "msg": "请求成功"
}}}}

> 论坛系统：
{{{#!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,
        "isTagTop":1,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },...
  ]
}}}


**返回参数说明**
> mrobot：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||

> 论坛系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||

=== 1.3标签帖子列表===
mrobot：/tagTopicList.xsp [[BR]]
论坛系统： http://bbs.pchouse.com.cn/rest/getTagList.ajax（新增） [[BR]]

**说明**
> 传递分页参数和标签id，论坛返回该标签下分页帖子列表。（标签帖子列表）[[BR]]
> 分页默认一页20条

**缓存时间**
>无缓存

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 论坛系统

**参数**
> mrobot：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||fid||板块id||int|| 185 ||是||= 板块id，对应这次新增的板块，一般来说是185  =||
||pageNo||页数||int||1||是||= 页数  =||
||pageSize||页面大小||int||20||是||= 每页大小  =||
||tagId||标签id||int|| ||是||= 单个标签id  =||

>论坛系统的参数请参照论坛同事给出的文档。

**返回**
> 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,
        "isTagTop":1,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },
    ...
  ]
}
}}}

> 论坛系统：
{{{#!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,
        "isTagTop":1,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },...
  ]
}}}


**返回参数说明**
> mrobot：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||

> 论坛系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||


=== 1.4个人主页帖子列表 ===
mrobot：/topicList.xsp [[BR]]
论坛系统： http://bbs.pchouse.com.cn/intf/user/_topics.jsp（修改） [[BR]]

**说明**
> 当只传了分页参数，论坛返回分页帖子列表。（发现帖子列表）[[BR]]
> 当传了分页参数和标签id，论坛返回该标签下分页帖子列表。（标签帖子列表）[[BR]]
> 当传了分页参数和用户id，论坛返回该用户下分页帖子列表。（个人主页、我的帖子列表）[[BR]]
> 如果同时存在标签id和用户id，暂定返回错误信息：参数有误 [[BR]]
> 分页默认一页20条

**缓存时间**
>无缓存

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 论坛系统

**参数**
> mrobot：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||fid||板块id||int|| 185 ||是||= 板块id，对应这次新增的板块，一般来说是185  =||
||pageNo||页数||int||1||是||= 页数  =||
||pageSize||页面大小||int||20||是||= 每页大小  =||
||uid||用户id||int|| ||是||= 单个用户id  =||

>论坛系统的参数请参照论坛同事给出的文档。

**返回**
> 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,
        "isTagTop":1,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },
    ...
  ]
}
}}}

> 论坛系统：
{{{#!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,
        "isTagTop":1,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },...
  ]
}}}


**返回参数说明**
> mrobot：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||

> 论坛系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 帖子列表 =||= data列表中的参数 =||= 参考论坛系统中对应接口的参数说明 =||
||= isTagTop =||= 是否标签顶置，1：是，0：否 =||= =||=   =||


[[BR]]
[[BR]]

=== 1.5帖子终端页（修改） ===
mrobot：http://mrobot.pchouse.com.cn/v3/bbs/topics/1307314?picRule=2&pageNo=1&pageSize=10 [[BR]]
论坛系统：http://bbs.pchouse.com.cn/rest/topics/1307314?picRule=2&pageNo=1&pageSize=10 [[BR]]
制作地址：http://zzsvn.pcauto.com.cn/svn/pchouse/pc/2016/bbs/0531-mgroup/ [[BR]]

**说明**
> 修改帖子终端页接口：主贴下的回帖不需要只看楼主了[[BR]]
> 论坛出数据，mrobot组装为html代码[[BR]]
> 页面需要提供js方法给App端实现点赞和取消点赞的页面动效，以及收藏和取消收藏的页面动效

**js方法**
> 点赞和取消点赞的页面动效：[[BR]]
> 收藏和取消收藏的页面动效：

**缓存时间**
>无缓存

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 论坛系统

**参数**
> mrobot、论坛系统：
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
|| topicId ||帖子id||int|| ||是||= 帖子 id,直接加在url后面  =||
||pageNo||页数||int||1||是||= 评论的页数  =||
||pageSize||页面大小||int||20||是||= 每页的评论条数  =||
|| picRule ||图片规则||int|| 0 ||否||= 移动网络的时候是0，wifi的时候是2  =||
|| v ||app版本号||int||  ||否||= app的版本号，3.3.0版本以前的版本不会传这个参数，包括3.3.0。格式为app版本号去掉小数点，例如3.4.0就是340  =||

**返回**
[[BR]]mrobot：
{{{#!java
mrobot返回的html中的json
/*@_HTML_META_START_
{
"postUrl":"http://bbs.pchouse.com.cn/topic-1307174.html"
"imageUrl":"http://imgm.pchouse.com.cn/images/upload/upc/tx/housebbs6/1605/18/c1/21658406_1463543973340_1024x1024house.jpg"
}
_HTML_META_END_@*/
}}}

论坛系统：
{{{#!java
{
    "curAllImage": [
        "p1_1_http://imgm.pchouse.com.cn/images/upload/upc/tx/housebbs6/1605/18/c1/21658406_1463543973340_1024x1024house.jpg"
    ],
    "postList": [
        {
            "agent": 1,
            "author": {
                "level": "建造工",
                "name": "mb42379906",
                "nickname": "鱼儿心情",
                "userFace": "http://i1.3conline.com/images/upload/upc/face/42/37/99/06/42379906_50x50",
                "userId": 42379906
            },
            "createAt": 1463543986000,
            "floor": 1,
            "message": "      被朋友带去一个好地儿，非常喜欢这里的装修风格，非常适合三五好友小聚，翻翻书，喝喝茶，以及美味可口的小糕点，惬意的午后时光……更有私人的藏酒柜，可以把好酒寄放在这里享受恒温恒湿的保管. ",
            "postId": 12010038,
            "status": 0
        },...
    ],
    "topic": {
        "author": {
            "level": "建造工",
            "name": "mb42379906",
            "nickname": "鱼儿心情",
            "userFace": "http://i1.3conline.com/images/upload/upc/face/42/37/99/06/42379906_50x50",
            "userId": 42379906
        },
        "bbsId": 105,
        "createAt": 1463543986000,
        "flag": "精",
        "forumId": 107,
        "forumName": "我用过",
        "lastPostAt": 1463633944000,
        "lastPoster": {
            "name": "mb42379906",
            "nickname": "鱼儿心情",
            "userId": 42379906
        },
        "replyCount": 40,
        "favorCount":3,
        "collectCount":5,
        "title": "朋友家庭聚会好去处...奢华中带有家的情调～",
        "uri": "http://bbs.pchouse.com.cn/topic-1307174.html",
        "view": 94,
        "tag":[
            {"id":"1", "name":"茶桌"},{"id":"2", "name":"衣柜"},...
        ]
    },
    "total": 41
}    
}}}

**返回参数说明**
> mrobot：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||

> 论坛系统：
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= favorCount =||= 点赞数 =||= collectCount =||= 收藏数  =||
||= tag =||= 标签列表 =||= =||=   =||

[[BR]]
[[BR]]

=== 1.6热门标签 ===
mrobot：/hotTag.xsp [[BR]]
虚拟币系统：[[BR]]
> 开发环境：http://dev19.pchouse.com.cn:9090/intf/hotTag.jsp [[BR]]
> 测试环境：[[BR]]

**说明**
> 获取编辑在后台维护的特殊标签。  [[BR]]
> 特殊标签有两类，一类是在发现页中展示的（是否发现），另一类是在发帖页中展示的（是否热门）。  [[BR]]
> 前者一般来说会有且最多有7个，后者一般来说会有且最多有5个

**缓存时间**
>15分钟

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 虚拟币系统

**参数**
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||= hotType =||= 热门类型 =||= int =||= 0 =||= 是 =||=0:返回7个‘是否发现’标签，1：返回5个‘是否热门’标签=||

**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功",
  "data":[{
          "tagId":"11",
          "tagName":"绿叶",
          "imageUrl":"http://imgm.pchouse.com.cn/images/upload/upc/tx/housebbs6/1605/18/c1/21658406_1463543973340_1024x1024house.jpg"
      },{
          "tagId":"12",
          "tagName":"餐具",
          "imageUrl":"http://imgm.pchouse.com.cn/images/upload/upc/tx/housebbs6/1605/18/c1/21658406_1463543973340_1024x1024house.jpg"
      }
      ...
  ]
}
}}}


**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= data =||= 标签列表 =||= tagId =||= 标签id =||
||= tagName =||= 标签名称 =||= imageUrl =||= 标签图片 =||

[[BR]]
[[BR]]

=== 1.7所有标签 ===
mrobot：/allTag.xsp [[BR]]
虚拟币系统：[[BR]]
> 开发环境：http://dev19.pchouse.com.cn:9090/intf/allTag.jsp [[BR]]
> 测试环境：[[BR]]

**说明**
> 获取编辑在后台维护的所有标签，分一级标签和二级标签。

**缓存时间**
>15分钟

**提交方式**
> GET

**是否登录**
> 否

**数据来源**
> 虚拟币系统

**参数**
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||


**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功",
  "data":[
    {
      "superTagId":"1",
      "superTagName":"文艺",
      "subTagList":[
          {
          "tagId":"11",
          "tagName":"绿叶"
          },...
      ]
    },...   
  ]
}
}}}


**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= superTagId =||= 一级标签id =||= superTagName =||= 一级标签名称 =||
||= tagId =||= 标签id =||= tagName =||= 标签名称 =||

[[BR]]
[[BR]]

=== 1.8发帖 ===
[http://rdtrac.pc.com.cn/bbs/wiki/intf "论坛接口"][[BR]]
论坛系统：http://bbs.pchouse.com.cn/rest/forums.jsp

**说明**
> 增加新参数：标签id、标签名称

**参数**
||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= tagIds =||= 帖子id =||= string =||= "1,2,3,4" =||= 是 =||= 多个标签id，逗号分隔  =||
||= tagNames =||= 帖子名称 =||= string =||= "标签1,标签2,标签3,标签4" =||= 是 =||= 多个标签名称，逗号分隔，与id一一对应 =||


[[BR]]
[[BR]]

=== 1.9对帖子点赞/取消赞 ===
论坛系统：topicSupport.jsp  [[BR]]

**说明**

> 对帖子点赞/取消赞。需要登录。

**缓存时间**

>0分钟

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

> 论坛系统

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= topicId =||=帖子id =||= int =||= "" =||= 是 =||=   =||
||= operType =||=操作类型=||= int =||= "" =||= 是 =||=1：点赞，2：取消点赞 =||


**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功"
}
{
  "status":-1,
  "msg":"不能重复点赞"
}
//其他情况可以补充
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 状态 =||= msg =||=信息=||

[[BR]]
[[BR]]

=== 1.10用户是否已经对贴子点赞 ===
mrobot地址：  /isSupportTopic.xsp [[BR]]
论坛系统：/isSupportTopic.jsp  [[BR]]

**说明**

> 获取该贴子是否已被用户点赞[[BR]]

**缓存时间**

>0分钟

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

>论坛后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||= topicId =||=帖子id =||= int =||= "" =||= 是 =||=   =||

**返回**

{{{#!java
{
  "status":0,
  "msg":"请求成功",
  "hasSupport":"0"

}

}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= hasSupport =||= 0：未点赞，1:已点赞 =||==||==||


[[BR]]
[[BR]]

=== 1.11对帖子收藏/取消收藏 ===
论坛系统：topicCollect.jsp  [[BR]]

**说明**

> 对帖子点赞/取消赞。需要登录。

**缓存时间**

>0分钟

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

> 论坛系统

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= topicId =||=帖子id =||= int =||= "" =||= 是 =||=   =||
||= operType =||=操作类型=||= int =||= "" =||= 是 =||=1：收藏，2：取消收藏 =||


**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功"
}
//其他情况可以补充
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 状态 =||= msg =||=信息=||


----------
== 2.首页 ==
----------
=== 2.1资讯首页接口（修改） ===
已有接口：[http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.1.0#a1资讯首页 "资讯首页"]

**说明**
> 推荐杂志字段latestPeriodical返回3篇推荐月刊，由cms后台维护 [[BR]]
> 焦点滚动图字段focus已不需要，可以不用返回

----------
== 3.推送 ==
----------
=== 3.1推送帖子信息到虚拟币系统 ===
虚拟币系统：[[BR]]
> 开发环境：http://dev19.pchouse.com.cn:9090/intf/submitTopic.jsp [[BR]]
> 测试环境：[[BR]]

**说明**
> 用户发帖提交到论坛系统后，由论坛系统将帖子图片url、用户id、发帖时间以及标签信息等推送到虚拟币系统，以供编辑对帖子的标签信息进行编辑。推送的时机为用户发帖到论坛系统保存后。 [[BR]]

**缓存时间**

>0分钟

**提交方式**

> POST

**数据来源**

> 论坛系统

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= topicId =||= 帖子id =||= int =||=  =||= 是 =||=   =||
||= uid =||= 用户id =||= int =||=  =||= 是 =||=   =||
||= imageUrl =||= 图片url =||= string =||= "" =||= 是 =||=   =||
||= tagIds =||= 标签id =||= string =||= "1,2,3,4,5" =||= 是 =||=  多个标签id，用逗号分隔 =||
||= postDate =||= 发帖时间 =||= string =||= "2016-02-27 23:32:58" =||= 是 =||=  发帖时间 =||

**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功"
}
//其他情况可以补充
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 状态 =||= msg =||=信息=||

[[BR]]
[[BR]]
=== 3.2推送帖子标签信息到论坛系统 ===
论坛系统：/updateTopic.jsp [[BR]]

**说明**
> 编辑可以在虚拟币系统中对帖子的标签信息进行编辑。 [[BR]]
> 虚拟币系统需要将帖子标签的修改结果以及设置为哪个标签顶置推送到论坛系统上更新。推送时机为每次编辑保存后。 [[BR]]

**缓存时间**

>0分钟

**提交方式**

> POST

**数据来源**

> 虚拟币系统

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= topicId =||= 帖子id =||= int =||=  =||= 是 =||=   =||
||= tagIds =||= 标签id =||= string =||= "1,2,3,4,5" =||= 是 =||=  多个标签id，用逗号分隔 =||
||= tagNames =||= 标签名称 =||= string =||= "标签1,标签2,标签3,标签4,标签5" =||= 是 =||=  多个标签名称，用逗号分隔，需要与标签id一一对应 =||
||= topTagId =||= 需要顶置的标签id =||= string =||= "" =||= 是 =||=  字符串为空时表示不需要标签顶置，非空时值就是对应需要顶置的标签id =||

**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功"
}
//其他情况可以补充
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 状态 =||= msg =||=信息=||

=== 3.3推送标签信息到论坛系统 ===
论坛系统：/updateTag.jsp [[BR]]

**说明**
> 编辑可以在虚拟币系统中对标签信息进行编辑。 [[BR]]
> 虚拟币系统需要将签的修改结果推送到论坛系统上更新。推送时机为每次编辑保存后。 [[BR]]

**缓存时间**

>0分钟

**提交方式**

> POST

**数据来源**

> 虚拟币系统

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= tagId =||= 标签id =||= int =||= 1 =||= 是 =||=  单个标签id =||
||= tagName =||= 标签名称 =||= string =||= "标签1" =||= 是 =||=  标签名称 =||

**返回**
{{{#!java
{
  "status":0,
  "msg":"请求成功"
}
//其他情况可以补充
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 状态 =||= msg =||=信息=||