| Version 42 (modified by hezhenwei1, 10 years ago) (diff) |
|---|
Table of Contents
时尚胶囊2.0.0接口文档
mrobot代理环境说明:
192.168.10.198:1080(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)
ps:未到qa阶段,连开发环境调试(若仅做代理,mrobot不存在真正的处理文件,只作转发的功能)
参考电脑网评论接口
参考聚超值评论接口
框架
设计稿地址
1.首页
1.1资讯首页
开发环境: http://dev15.pclady.com.cn/app/dayArticles.jsp
线上环境: http://plastic.pclady.com.cn/app/dayArticles.jsp
mrobot地址: http://mrobot.pclady.com.cn/dayArticles.xsp
说明
获取资讯栏目的首页精选数据。
列表中的文章数据按天(服务器时间)进行分页,每次返回的数据为某一天的文章数据,参数中用date来标识,如果date为空表示加载当天数据,随后后端返回数据时需要一同返回这些数据是属于哪天的,和有数据的下一天的日期nextDate。
数据异常机制:当天必须要有焦点文章,如果没有焦点文章,即使有文章数据也跳过该天,随后返回最近有焦点文章那天的文章列表。
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| day | 指定天数 | int | 0 | 是 | 为0时返回当天的,1为昨天的,2为前天的,以此类推 |
返回
{
"status":0,
"msg":"请求成功",
"data":{
"focus":{
"focusID":"焦点图ID",
"imageUrl":"焦点图片",
"desc":"焦点图简介",
"focusDate":"焦点日期"//YYYY-MM-DD,
"hasLaud":"1"
},
"articleList":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"authorID":"作者ID",
"authorName":"作者昵称",
"authorImageUrl":"作者头像",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字"
}
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorName | 作者昵称 | authorID | 作者ID |
| focusDate | 焦点图上显示的时间 | hasLaud | 焦点图点赞情况,0为既没点赞也没踩,1为点赞过了,2为踩过了 |
1.2文章终端页 (WEB)
开发环境: http://dev15.pclady.com.cn/app/articleInfo.jsp
线上环境: http://plastic.pclady.com.cn/app/articleInfo.jsp
mrobot地址: http://mrobot.pclady.com.cn/article.xsp
说明
获取指定文章终端页的内容
应用端出相关数据与文章html,wap页由mrobot来完成,评论数据从评论系统获取,参考 1.3文章评论列表
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| articleID | 文章ID | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 否 | |
| fmt | fmt=json 时显示接口数据 | String | "" | 否 | |
| appVersion= | 版本号 | string | "" | 否 | |
| inReview= | 1:审核状态 0:发布状态 | int | 0 | 否 | ios审核时用到 |
返回
{
"status":0,
"msg":"请求成功",
"articleID":"文章ID",
"authorID":"作者ID",
"authorName":"作者昵称",
"authorWXID":"作者微信订阅号",
"headImageUrl":"文章头图",
"title":"文章标题",
"collectCount":100,
"supportCount":100,
"opposeCount":50,
"sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss",
"html":"文章html文本",
"css":"样式文本",//看后端怎么保存文章的,html和css、js等放一起也可以
"relativeSpecialList":[
{//相关专题
"specialID":"专题ID",
"specialName":"专题名称",
"introduceText":"专题简介文本",
"imageUrl":"专题图片",
"articleCount":"文章篇数",
"followCount":"关注人数"
},
......
],
"tagList":[
{
"tagID":"标签ID",
"tagText":"标签文本"
},
......
]
}
mrobot返回的html中的json
{
"collectCount":100,
"commentCount":50
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| collectCount | 文章被收藏次数 | commentCount | 文章评论数量 |
1.3文章评论列表
说明
获取文章评论列表,走评论系统,参考电脑网: http://trac.pc.com.cn/iphone/wiki/pconline_3.7.0/interface#a2.2 聚超值: http://trac.pc.com.cn/iphone/wiki/price_jiekou#a2.4评论列表接口
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| topicID | 主题ID | string | "" | 是 | 需要获取评论主题id |
| articleId | 文章ID | string | "" | 是 | |
| reverse | 排序方式 | string | "" | 是 | 0 倒序; 1 正序 |
返回
{
"comments": [
{ //没有引用其他评论的评论
"1": { //表达其引用关系的key
"id":"24991904",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称
"floor": "1737", //楼层
"time": "2013-01-05 09:05:40", //时间
"content": "内容过于暴力,已和谐" //内容
},
"current":"1", //当前最外层引用标识
"support":"10086" //"顶"数量
"expand":false //判断是否展开,默认为false
},
{
"3": {
"id":"24991804",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ",
"floor": "1737",
"time": "2013-01-05 09:05:40",
"content": "内容过于暴力,已和谐"
},
"2": {
"id":"24941904",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ",
"floor": "1737",
"time": "2013-01-05 09:05:40",
"content": "内容过于暴力,已和谐"
},
"1": {
"id":"24491904",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ",
"floor": "1737",
"time": "2013-01-05 09:05:40",
"content": "内容过于暴力,已和谐"
},
"4": {
"id":"24993904",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ",
"floor": "1737",
"time": "2013-01-05 09:05:40",
"content": "内容过于暴力,已和谐"
},
"current":"4",
"support":"10086" //顶数
"expand":false //判断是否展开,默认为false
}
],
"hot-comments": [
{ //没有引用其他评论的评论
"1": { //表达其引用关系的key
"id":"24691904",//帖子id
"name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称
"floor": "1737", //楼层
"time": "2013-01-05 09:05:40", //时间
"content": "内容过于暴力,已和谐" //内容
},
"current":"1"
"support":"10086" //顶数
"expand":false //判断是否展开,默认为false
}
],
"docUrl": "http://im_an_artical"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| nickName | 用户昵称 | userID | 用户ID |
1.4标签文章列表
()
/tagArticles.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
点击标签后,获取带有该关键字的文章列表,app不作缓存
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| tagID | 标签ID | string | 是 | ||
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":{
"articleList":[
{
"authorID":"作者ID",
"authorName":"作者名称",
"articleID":"文章ID",
"title":"文章标题",
"articleID":"文章ID",
"imageUrl":"文章图片"
}
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorID | 作者ID | authorName | 作者名称 |
1.5焦点页点赞、踩
/supportFocus.jsp
开发环境: http://dev15.pclady.com.cn/app/supportFocus.jsp
线上环境: http://plastic.pclady.com.cn/app/supportFocus.jsp
mrobot地址: http://mrobot.pclady.com.cn/supportFocus.xsp
说明
对焦点页进行点赞或踩。如果焦点页未被赞、踩,那么则对焦点页进行赞、踩操作。如果已赞或已踩,则切换赞、踩状态,不能取消点赞或取消踩
缓存时间
0分钟
提交方式
POST
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| focusID | 焦点图ID | string | "" | 是 | |
| sp | 操作类型 | string | "" | 是 | 1:点赞,2:踩 |
| common_session_id | 太平洋通行证session | string | "" | 否 | 如果登陆了就传 |
| deviceID | 设备ID | string | "" | 是 | 根据设备号判定(是否需要与评论点赞的保持一致?) |
返回
{
"status":0,
"msg":"请求成功"
}
{
"status":1,
"msg":"您已经赞过了,不能重复点赞"
}
{
"status":2,
"msg":"您已经踩过了,不能重复踩"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
1.6文章点赞、踩
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
说明
对文章页进行点赞或踩。如果文章页未被赞、踩,那么则文章点页进行赞、踩操作。如果已赞或已踩,则切换赞、踩状态,但不能重复点赞或重复踩。
缓存时间
0分钟
提交方式
POST
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| focusID | 焦点图ID | string | "" | 是 | |
| sp | 操作类型 | string | "" | 是 | 1:点赞,2:踩 |
| common_session_id | 太平洋通行证session | string | "" | 否 | 如果登陆了就传 |
| deviceID | 设备ID | string | "" | 是 | 根据设备号判定(是否需要与评论点赞的保持一致?) |
返回
{
"status":0,
"msg":"您对文章表态成功"
}
{
"status":1,
"msg":"您已经对文章表态过了"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
1.7评论点赞
经评论系统
url: http://cmt.pclady.com.cn/action/comment/support_json.jsp
说明
对评论进行点赞
缓存时间
0分钟
提交方式
POST
是否登录
否
数据来源
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| cid | 评论ID | string | "" | 是 | |
| sp | 点赞操作 | string | "" | 是 | >0代表点赞 ,<=0代表反对 |
返回
{
"support": 2,
"floor": 2,
"status": 0,
"topicId": 13205153,
"postId": 36813920
}
{
message: "您已对该评论投过票,不可重复投票",
status: -1
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
1.8评论发送
经评论系统
url: http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
说明
评论列表页中发表评论
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| id | 话题id | string | "" | 是 | |
| url | 话题url | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| username | 用户名 | string | "" | 是 | |
| anonymous | 是否匿名 | string | "" | 是 | |
| content | 回复内容 | string | "" | 是 | 回复内容 |
| replyFloor2 | 回复楼层 | string | "" | 否 |
返回
{
"commentId":25705754,
"floor":27,
"showName":"iostester",
"brief":"Really good car hm~~~",
"status":0,
"createTime":"2013-07-19 10:37:03",
"resultCode":0,
"resultMsg":"您的评论已经成功发表。注:评论在审核后才能出现在列表中,谢谢!",
"userId":25520497
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
1.9收藏文章
开发环境: http://dev15.pclady.com.cn/app/collectArticle.jsp
线上环境: http://plastic.pclady.com.cn/app/collectArticle.jsp
mrobot地址: http://mrobot.pclady.com.cn/collectArticle.xsp
说明
收藏或取消收藏指定文章,根据参数type区分
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| articleID | 文章id | string | "" | 是 | |
| type | 操作类型 | int | "" | 是 | 1:收藏 ,2:取消收藏 |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"已成功收藏"
}
{
"status":1,
"msg":"已取消收藏"
}
{
"status":-1,
"msg":"错误原因"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
1.10焦点图点赞、踩状态查询
开发环境: http://dev15.pclady.com.cn/app/focusSupportState.jsp
线上环境: http://plastic.pclady.com.cn/app/focusSupportState.jsp
mrobot地址: http://mrobot.pclady.com.cn/focusSupportState.xsp
说明
查询某设备或用户对某焦点图的点赞、踩状态
缓存时间
0分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| focusID | 焦点图id | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| deviceID | 设备ID | string | "" | 是 | 根据设备号判定(是否需要与评论点赞的保持一致?) |
返回
{
"status":0,
"msg":"请求成功",
"data":{
"state":"0"
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| state | 0:未点赞未踩,1:已点赞,2:已踩 |
1.11文章是否被用户收藏
开发环境: http://dev15.pclady.com.cn/app/isArticleCollected.jsp
线上环境: http://plastic.pclady.com.cn/app/isArticleCollected.jsp
mrobot地址: http://mrobot.pclady.com.cn/isArticleCollected.xsp
说明
获取该文章是否已被用户收藏
缓存时间
0分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| articleID | 文章id | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"请求成功",
"hasCollected":"1"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| hasCollected | 0:为收藏,1:已收藏 |
2.专题
2.1专题频道页
()
/specialIndex.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取专题首页中我的专题、热门专题、其他专题列表
我的专题中显示我订阅专题内最新更新的一篇文章,以及自上一次进入我的订阅页面后累计更新的文章数,若用户无订阅任何专题或未登录,不需要返回此节点
热门专题列表读取后台中设定的3个热门专题
其他专题列表读取后台中设定的专题,若干个一级专题,一级专题下有4个露出二级专题
缓存时间
15分钟
提交方式
GET
是否登录
否/是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| common_session_id | 太平洋通行证session | string | "" | 否 | |
| pageNo | 页码 | int | 1 | 是 | 当pageNo为1时需要返回我的专题和热门专题 |
| pageSize | 每页行数 | int | 5 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 5,
"total": 100,
"data":{
"mySpecial":{ //我的专题,如果没登陆,或者用户没关注,则不需要返回
"specialID":"专题ID",
"specialName":"专题名称",
"authorID":"作者ID",
"authorName":"作者名称",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字",
"newCount":"已更新文章数"
},
"hotSpecial":[ //热门专题,3个
{
"specialID":"专题ID",
"specialName":"专题名称",
"articleCount":"文章篇数"
"followCount":"关注人数",
"imageUrl":"专题图片"
},
......
],
"specialList":[ //一级专题列表中包含最多4个二级专题
{
"specialID":"专题ID",
"specialName":"专题名称",
"secondaryCount":"二级专题数量",
"secondaryList":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"imageUrl":"焦点图片"
},
......
]
},
......
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorName | 作者名称 | authorID | 作者ID |
| pageNo | 一级专题的pageNo | pageSize | 一级专题的pageSize |
| total | 一级专题的总数 | newCount | 我的订阅中新文章数量 |
2.2专题主页
()
/specialContentPage.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取指定专题的专题介绍栏、分类标签栏、内容列表
app不作缓存
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| common_session_id | 太平洋通行证session | string | "" | 否 | |
| pageNo | 内容页数 | int | 1 | 是 | 为1时需要返回专题介绍栏、分类标签栏 |
| pageSize | 内容页数 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":{
"specialIntroduce":{ //专题介绍栏
"specialID":"专题ID",
"specialName":"专题名称",
"introduceText":"专题简介文本",
"imageUrl":"专题图片",
},
"specialColumn":{ //分类标签栏 包含一篇最新文章
"authorID":"作者ID",
"authorName":"作者昵称",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字",
"articleCount":"专题文章篇数",
"followCount":"专题关注人数",
"authorCount":"专题作者人数"
},
"articleList":[ //专题中的内容列表,不包括分类标签栏中的那篇
{
"authorID":"作者ID",
"authorName":"作者昵称",
"articleID":"文章id",
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字",
"superSpecialName":"所属一级专题名称",
},
......
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorName | 作者名称 | authorID | 作者ID |
| superSpecialName | 文章所属专题的分类名称 | ||
| articleCount | 该专题下的文章数量 | followCount | 该专题下的关注人数 |
| authorCount | 该专题下的作者人数 |
2.3所有专题页
()
/childSpecialList.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取指定一级专题下的二级专题列表
app不作缓存
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| superSpecialID | 一级专题id | string | "" | 是 | |
| pageNo | 内容页数 | int | 1 | 是 | |
| pageSize | 内容页数 | int | 15 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 15,
"total": 100,
"data":{
"superSpecialDesc":"一级专题的描述信息",
"specialList":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"introduceText":"专题简介文本",
"imageUrl":"专题图片",
"articleCount":"文章篇数",
"followCount":"关注人数"
},
......
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| superSpecialDesc | 一级专题的描述信息,显示在标题中 | ||
| articleCount | 该专题下的文章数量 | followCount | 该专题下的关注人数 |
2.4订阅专题页
()
/subscribeSpecial.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
登陆后订阅专题页
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| specialID | 专题id | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"已成功订阅"
}
{
"status":0,
"msg":"已取消订阅"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
3.互动
3.1活动频道页
()
/activityList.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
读取活动列表,20条一组 app不做缓存
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":{
"activityList":[
{
"activityID":"活动ID",
"activityName":"活动名称",
"activityType":"活动类型",
"userCount":"参与用户人数",
"data":"活动发布日期"
"imageUrl":"活动图片",
"desc":"活动简介前25字"
},
......
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| activityType | 1:投票,2:话题 |
3.2投票活动详情页(WEB)
开发环境: http://dev15.pclady.com.cn/app/voteInfo.jsp
线上环境: http://plastic.pclady.com.cn/app/voteInfo.jsp
mrobot地址: http://mrobot.pclady.com.cn/vote.xsp
说明
投票详情页,应用端返回投票页详情,mrobot端组装wap页,评论数据从评论系统获取,参考 1.3文章评论列表
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| activityID | 活动ID | string | "" | 是 | |
| activityType | 活动类型 | string | "1" | 是 | 1:投票,2:话题 |
| common_session_id | 太平洋通行证session | string | "" | 否 | |
| fmt | fmt=json 时显示接口数据 | String | "" | 否 | |
| appVersion= | 版本号 | string | "" | 否 | |
| inReview= | 1:审核状态 0:发布状态 | int | 0 | 否 | ios审核时用到 |
返回
{
"status":0,
"msg":"请求成功",
"activityID":"活动ID",
"activityType":"活动类型",
"activityTitle":"活动标题",
"activityDesc":"活动简介",
"imageUrl":"活动图片",
"userCount":"参与人数",
"optionList":[//投票选项
{
"optionID":"选项ID",
"optionTile":"选项标题",
"optionImageUrl":"选项图片"
},
......
]
}
mrobot返回的html中的json
{
"collectCount":100,
"commentCount":50
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| collectCount | 文章被收藏次数 | commentCount | 文章评论数量 |
3.3话题活动详情页(WEB)
开发环境: http://dev15.pclady.com.cn/app/topicInfo.jsp
线上环境: http://plastic.pclady.com.cn/app/topicInfo.jsp
mrobot地址: http://mrobot.pclady.com.cn/topic.xsp
说明
话题详情页,应用端返回话题页详情,mrobot端组装wap页,评论数据从评论系统获取,参考 1.3文章评论列表
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| activityID | 活动ID | string | "" | 是 | |
| activityType | 活动类型 | string | "2" | 是 | 1:投票,2:话题 |
| common_session_id | 太平洋通行证session | string | "" | 否 | |
| fmt | fmt=json 时显示接口数据 | String | "" | 否 | |
| appVersion= | 版本号 | string | "" | 否 | |
| inReview= | 1:审核状态 0:发布状态 | int | 0 | 否 | ios审核时用到 |
返回
{
"status":0,
"msg":"请求成功",
"activityID":"活动ID",
"activityType":"活动类型",
"activityTitle":"活动标题",
"activityDesc":"活动简介",
"imageUrl":"活动图片",
"userCount":"参与人数",
"html":"话题正文html"
}
mrobot返回的html中的json
{
"collectCount":100,
"commentCount":50
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| collectCount | 文章被收藏次数 | commentCount | 文章评论数量 |
3.4收藏活动
开发环境: http://dev15.pclady.com.cn/app/collectActivity.jsp
线上环境: http://plastic.pclady.com.cn/app/collectActivity.jsp
mrobot地址: http://mrobot.pclady.com.cn/collectActivity.xsp
说明
收藏或取消收藏指定活动,根据type区分
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| activityID | 活动id | string | "" | 是 | |
| type | 操作类型 | int | "" | 是 | 1:收藏 ,2:取消收藏 |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"已成功收藏"
}
{
"status":0,
"msg":"已取消收藏"
}
{
"status":-1,
"msg":"错误原因"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|
3.5活动是否被用户收藏
开发环境: http://dev15.pclady.com.cn/app/isActivityCollected.jsp
线上环境: http://plastic.pclady.com.cn/app/isActivityCollected.jsp
mrobot地址: http://mrobot.pclady.com.cn/isActivityCollected.xsp
说明
获取该活动是否已被用户收藏
缓存时间
0分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| activityID | 活动id | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"请求成功",
"hasCollected":"1"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| hasCollected | 0:未收藏,1:已收藏 |
4.自媒体
4.1自媒体列表
()
/authorList.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
读取所有自媒体列表
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 40 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 40,
"total": 100,
"data":[
{
"authorID":"作者ID",
"authorName":"作者名称",
"authorWXID":"作者微信公众号",
"imageUrl":"作者头像",
"desc":"简介",
},
......
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorName | 作者名称 | authorID | 作者ID |
4.2自媒体主页
()
/authorIndex.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取指定自媒体的主页信息
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| authorID | 自媒体ID | int | 是 | ||
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":{
"author":{
"authorID":"作者ID",
"authorName":"作者名称",
"authorWXID":"作者微信公众号",
"imageUrl":"作者头像",
"desc":"简介",
"supportCount":"点赞数",
"opposeCount":"反对数"
},
"articleList":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"authorID":"作者ID",
"authorName":"作者名称",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字"
},
......
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| authorName | 作者名称 | authorID | 作者ID |
5.个人中心
5.1修改昵称
/syncNickName.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
修改昵称
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| nickName | 昵称 | string | "" | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 |
返回
{
"status":0,
"msg":"请求成功",
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| status | 返回状态 |
5.2修改头像
url: http://upc.pconline.com.cn/upload_head.jsp
说明
修改头像
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| form-data | 二进制图片数据 | 是 | |||
返回
{
"status":0,
"msg":"请求成功"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| status | 返回状态 |
5.3我的收藏
/myCollection.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取我的收藏列表,分为文章与活动两种
缓存时间
15分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页码 | int | 1 | 是 | |
| pageSize | 每页行数 | int | 20 | 是 | |
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| type | 类型 | int | 是 | 0:文章 1:活动 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"authorID":"作者ID",
"authorName":"作者名称",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字"
},
......
]
}
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":[
{
"activityID":"活动ID",
"activityName":"活动名称",
"activityType":"活动类型",
"userCount":"参与用户人数",
"data":"活动发布日期"
"imageUrl":"活动图片",
"desc":"活动简介前25字"
},
......
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| status | 返回状态 |
5.4我的订阅(专题)
/subscribedSpecialList.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取用户已订阅的专题列表
缓存时间
15分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| pageNo | 页码 | int | 1 | 是 | |
| pageSize | 每页行数 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"specialList":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"introduceText":"专题简介文本",
"imageUrl":"专题图片",
"articleCount":"文章篇数",
"followCount":"关注人数"
},
......
]
}
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| status | 返回状态 |
5.5我的订阅(更新)
/subscribedArticleList.jsp
开发环境: http://dev15.pclady.com.cn/app/
线上环境: http://plastic.pclady.com.cn/app/
mrobot地址: http://mrobot.pclady.com.cn/
说明
获取我的订阅中自订阅时间起更新的所有文章
缓存时间
15分钟
提交方式
GET
是否登录
是
数据来源
编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| common_session_id | 太平洋通行证session | string | "" | 是 | |
| pageNo | 页码 | int | 1 | 是 | |
| pageSize | 每页行数 | int | 20 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data":[
{
"specialID":"专题ID",
"specialName":"专题名称",
"authorID":"作者ID",
"authorName":"作者名称",
"articleID":"文章id"
"imageUrl":"文章图片",
"title":"文章标题",
"desc":"文章正文前xxx字"
"datetime":"YYYY-MM-DD HH:mm:ss"
},
......
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| datetime | 文章的更新时间 |
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)