wiki:pchouse_magazine_interface_3.4.0

Version 8 (modified by hezhenwei1, 10 years ago) (diff)

--

家居杂志iPhone3.4.0接口文档

环境说明:

 产品文档
[ "设计稿地址"]
 终端页协议

1.圈子


1.1精选帖子列表

mrobot:/selectedTopic.xsp
虚拟币系统:/selectedTopicIds.jsp
论坛系统:
论坛系统可参考: 根据帖子id批量获取帖子详情

说明

获取精选帖子列表数据,最多30条精选帖子,每页10条,最多3页。
帖子数据保存在论坛系统,但精选帖子的id保存在虚拟币系统,所以需要mrobot端先从虚拟币系统获取所有精选帖子的id,再根据分页页数带上对应的帖子id到论坛系统查询帖子数据。

缓存时间

无缓存

提交方式

GET

是否登录

数据来源

虚拟币系统
论坛系统

参数 mrobot:

参数名 参数含义 类型 默认值 是否必须 说明
pageNo页数int1 页数
pageSize页面大小int10 每页大小

虚拟币系统:

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

论坛系统:

参数名 参数含义 类型 默认值 是否必须 说明
topicIds帖子idstring "" 多个帖子的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页数int1 页数
pageSize页面大小int20 每页大小
tagId标签idint 单个标签id
uid用户idint 单个用户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?
论坛系统:
制作地址:

说明

修改帖子终端页接口:主贴下的回帖不再需要分页,直接全部返回,也不需要只看楼主了
页面需要提供js方法给App端实现点赞和取消点赞的页面动效,以及收藏和取消收藏的页面动效

缓存时间

无缓存

提交方式

GET

是否登录

数据来源

论坛系统

参数 mrobot、论坛系统:

参数名 参数含义 类型 默认值 是否必须 说明
topicId 帖子idint topicId 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列表中的参数 参考论坛系统中对应接口的参数说明