| Version 10 (modified by hezhenwei1, 10 years ago) (diff) |
|---|
Table of Contents
家居杂志iPhone3.4.0接口文档
环境说明:
1.圈子
1.1精选帖子列表
mrobot:/selectedTopic.xsp
虚拟币系统:/selectedTopicIds.jsp
论坛系统:
论坛系统可参考: 根据帖子id批量获取帖子详情
说明
获取精选帖子列表数据,最多30条精选帖子,每页10条,最多3页。
帖子数据保存在论坛系统,但精选帖子的id保存在虚拟币系统,所以需要mrobot端先从虚拟币系统获取所有精选帖子的id,再根据分页页数带上对应的帖子id到论坛系统查询帖子数据。
缓存时间
无缓存
提交方式
GET
是否登录
否
数据来源
虚拟币系统
论坛系统
参数 mrobot:
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | 页数 |
| pageSize | 页面大小 | int | 10 | 是 | 每页大小 |
虚拟币系统:
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|
论坛系统:
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| topicIds | 帖子id | string | "" | 是 | 多个帖子的id,以逗号分隔 |
返回
mrobot:
{
"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":"衣柜"},...
]
},
...
]
}
虚拟币系统:
{
"status":0,
"msg":"请求成功",
"data":["1","2","3",...,"30"]
}
论坛系统:
[{
"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 | 帖子对应的标签列表 |
虚拟币系统:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| data | 精选帖子id列表 |
论坛系统:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| tag | 帖子对应的标签列表 | data列表中的参数 | 参考论坛系统中对应接口的参数说明 |
| favorCount | 点赞数 | collectCount | 收藏数 |
1.2帖子列表(发现、标签、个人主页)
mrobot:/discoveryTopic.xsp
论坛系统:
说明
当只传了分页参数,论坛返回所有帖子列表。(发现帖子列表)
当传了分页参数和标签id,论坛返回该标签下所有帖子列表。(标签帖子列表)
当传了分页参数和用户id,论坛返回该用户下所有帖子列表。(个人主页帖子列表)
如果同时存在标签id和用户id,暂定返回错误信息:参数有误 分页默认一页20条
缓存时间
无缓存
提交方式
GET
是否登录
否
数据来源
论坛系统
参数 mrobot、论坛系统:
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | 页数 |
| pageSize | 页面大小 | int | 20 | 是 | 每页大小 |
| tagId | 标签id | int | 否 | 单个标签id | |
| uid | 用户id | int | 否 | 单个用户id |
返回
mrobot:
{
"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":"衣柜"},...
]
},...
]
返回参数说明
mrobot:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| data | 帖子列表 | data列表中的参数 | 参考论坛系统中对应接口的参数说明 |
| favorCount | 点赞数 | collectCount | 收藏数 |
论坛系统:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| data | 帖子列表 | data列表中的参数 | 参考论坛系统中对应接口的参数说明 |
| favorCount | 点赞数 | collectCount | 收藏数 |
1.3帖子终端页(修改)
mrobot: http://mrobot.pchouse.com.cn/v3/bbs/topics?topicId=1103978[[BR]]
论坛系统:
制作地址:
说明
修改帖子终端页接口:主贴下的回帖不再需要分页,直接全部返回,也不需要只看楼主了
页面需要提供js方法给App端实现点赞和取消点赞的页面动效,以及收藏和取消收藏的页面动效
缓存时间
无缓存
提交方式
GET
是否登录
否
数据来源
论坛系统
参数 mrobot、论坛系统:
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| topicId | 帖子id | int | 是 | 帖子 id |
返回
mrobot:
{
"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":"衣柜"},...
]
}]
返回参数说明
mrobot:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| data | 帖子列表 | data列表中的参数 | 参考论坛系统中对应接口的参数说明 |
论坛系统:
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| data | 帖子列表 | data列表中的参数 | 参考论坛系统中对应接口的参数说明 |
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)