wiki:pclady_news2.0.0_api

Context Navigation

Version 64 (modified by hezhenwei1, 10 years ago) (diff)
--

时尚胶囊2.0.0接口文档

mrobot代理环境说明：

192.168.10.198：1080(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
ps1:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能）
ps2:凡是参数说明中出现common_session_id的，都是指在cookies中添加此参数

框架
 设计稿地址
 终端协议
 评论系统接口

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

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
date	指定日期	string	""	否	为空时返回服务器当天数据，随后使用后端返回的nextDate来请求，格式YYYY-MM-DD

{
  "status":0,
  "msg":"请求成功",
  "data":{
    "date":"数据所属日期",//YYYY-MM-DD
    "nextDate":"下次请求的日期",//YYYY-MM-DD
    "focusArtical":{  //焦点文章
      "authorID":"作者ID",
      "authorName":"作者昵称",
      "authorUrl":"作者头像",
      "articleID":"文章id",
      "imageUrl":"文章图片",
      "title":"文章标题",
      "desc":"文章正文前xxx字",
      "focusImageUrl":"焦点文章图片"  //为文章配置的焦点图
    },
    "articleList":[
      { 
        "specialID":"所属一级专题ID",
        "specialName":"所属一级专题名称",
        "authorID":"作者ID",
        "authorName":"作者昵称",
        "authorUrl":"作者头像",
        "articleID":"文章id"
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字"
      }
    ],
    "focusImage":{  //焦点图
      "focusID":"焦点图ID",
      "imageUrl":"焦点图片",
      "desc":"焦点图简介"
    }
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
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来完成评论数据从评论系统获取，参考评论系统接口

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
articleID	文章ID	string	""	是
fmt	fmt=json时直接返回后台json，fmt=wap时返回分享格式的文章终端页，为空时返回客户端使用的文章终端页	String	""	否
appVersion=	版本号	string	""	否	如2.0.0
inReview=	1：审核状态 0：发布状态	int	0	否	ios审核时用到
terminal	1：iOS 2：Android	int	0	是
common_session_id	太平洋通行证session	string	""	否	cookies中添加

{
  "status":0,
  "msg":"请求成功",
  "articleID":"文章ID",
  "topicID":"话题ID"//url+文章id
  "authorID":"作者ID",
  "authorName":"作者昵称",
  "authorUrl":"作者头像",
  "authorWXID":"作者微信订阅号",
  "headImageUrl":"文章头图",
  "title":"文章标题",
  "collectCount":100,
  "supportCount":100,
  "opposeCount":50,
  "sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss",
  "html":"文章html文本",
  "secondarySpecialList":[
    {//相关二级专题
      "secondarySpecialID":"二级专题ID",
      "secondarySpecialName":"二级专题名称",
      "secondarySpecialText":"二级专题简介文本"
      "articleCount":"文章篇数",
      "followCount":"关注人数"
    },
    ......
  ],
  "tagList":[
    {
      "tagID":"标签ID",
      "tagText":"标签文本"
    },
    ......
  ]
}

mrobot返回的html中的json
{
  "collectCount":100,
  "commentCount":50
}

返回参数说明

参数名	参数含义	参数名	参数含意
collectCount	文章被收藏次数	commentCount	文章评论数量

1.3文章评论列表

mrobot地址： http://mrobot.pclady.com.cn/v3/cmt/new_topics/topicID?articleId=6111016&pageSize=20&pageNo=1&reverse=0

说明

获取文章评论列表，走评论系统，参考电脑网： 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，主题id由固定url（待定）+文章id 组成
articleId	文章ID	string	""	是
reverse	排序方式	string	""	是	0 倒序； 1 正序

{
  "comments": [
    {  //没有引用其他评论的评论
      "1": { //表达其引用关系的key
        "id":"24991904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",  //用户名称
        "floor": "1737",  //楼层
        "time": "2013-01-05 09:05:40",  //时间
        "content": "内容过于暴力,已和谐" //内容
      },
      "current":"1",               //当前最外层引用标识
      "support":"10086"       //"顶"数量
      "expand":false  //判断是否展开，默认为false
    },
    {
      "3": {
        "id":"24991804",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "2": {
        "id":"24941904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "1": {
        "id":"24491904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "4": {
        "id":"24993904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "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": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",  //用户名称
        "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标签文章列表

开发环境： http://dev15.pclady.com.cn/app/tagArticles.jsp
线上环境： http://plastic.pclady.com.cn/app/tagArticles.jsp
mrobot地址： http://mrobot.pclady.com.cn/tagArticles.xsp

说明

点击标签后，获取带有该关键字的文章列表，app不作缓存

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须
tagID	标签ID	string		是
pageNo	页数	int	1	是
pageSize	页面大小	int	20	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "tagName":"标签名"
  "data":[
      { 
        "specialID":"所属一级专题ID",
        "specialName":"所属一级专题名称",
        "authorID":"作者ID",
        "authorName":"作者名称",
        "authorUrl":"作者头像",
        "articleID":"文章ID",
        "title":"文章标题",
        "imageUrl":"文章图片"
      }
    ]
}

返回参数说明

参数名	参数含义	参数名	参数含意
authorID	作者ID	authorName	作者名称

1.5焦点页点赞、踩

开发环境： http://dev15.pclady.com.cn/app/supportFocus.jsp
线上环境： http://plastic.pclady.com.cn/app/supportFocus.jsp

说明

对焦点页进行点赞或踩。如果焦点页未被赞、踩，那么则对焦点页进行赞、踩操作。如果已赞或已踩，则切换赞、踩状态，不能取消点赞或取消踩

缓存时间

0分钟

提交方式

POST

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
focusID	焦点图ID	string	""	是
sp	操作类型	string	""	是	1：点赞，2：踩
common_session_id	太平洋通行证session	string	""	否	如果登陆了就传,cookies中添加
deviceID	设备ID	string	""	是	根据设备号判定（是否需要与评论点赞的保持一致？）

{
  "status":0,
  "msg":"请求成功"
}
{
  "status":1,
  "msg":"您已经赞过了，不能重复点赞"
}
{
  "status":2,
  "msg":"您已经踩过了，不能重复踩"
}

返回参数说明

参数名	参数含义	参数名	参数含意

1.6文章点赞、踩

开发环境： http://dev15.pclady.com.cn/app/supportArticle.jsp
线上环境： http://plastic.pclady.com.cn/app/supportArticle.jsp

说明

对文章页进行点赞或踩。如果文章页未被赞、踩，那么则文章点页进行赞、踩操作。如果已赞或已踩，则切换赞、踩状态，但不能重复点赞或重复踩。

缓存时间

0分钟

提交方式

POST

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
focusID	焦点图ID	string	""	是
sp	操作类型	string	""	是	1：点赞，2：踩
common_session_id	太平洋通行证session	string	""	否	如果登陆了就传,cookies中添加
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	""	是	cookies中添加
username	用户名	string	""	是
anonymous	是否匿名	string	""	是
content	回复内容	string	""	是	回复内容
replyFloor2	回复楼层	string	""	否	时尚胶囊暂时不支持二级评论，故此参数可以无视

{
    "commentId":25705754,
    "floor":27,
    "showName":"iostester",
    "brief":"Really&nbsp;good&nbsp;car&nbsp;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

说明

收藏或取消收藏指定文章，根据参数type区分

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
articleID	文章id	string	""	是
type	操作类型	int	""	是	1：收藏，2：取消收藏
common_session_id	太平洋通行证session	string	""	是	cookies中添加

{
  "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	""	否·	cookies中添加
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	""	是	cookies中添加

{
  "status":0,
  "msg":"请求成功",
  "hasCollected":"1"
}

返回参数说明

参数名	参数含义	参数名	参数含意
hasCollected	0：未收藏，1:已收藏

2.专题

2.1专题频道页

开发环境： http://dev15.pclady.com.cn/app/specialIndex.jsp
线上环境： http://plastic.pclady.com.cn/app/specialIndex.jsp
mrobot地址： http://mrobot.pclady.com.cn//specialIndex.xsp

说明

获取专题首页中我的专题、热门专题、其他专题列表
我的专题中显示我订阅专题内最新更新的一篇文章，以及自上一次进入我的订阅页面后累计更新的文章数，若用户无订阅任何专题或未登录，不需要返回此节点
热门专题列表读取后台中设定的3个热门专题
其他专题列表读取后台中设定的专题，若干个一级专题，一级专题下有4个露出二级专题

缓存时间

15分钟

提交方式

GET

是否登录

否/是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
common_session_id	太平洋通行证session	string	""	否	cookies中添加
pageNo	页码	int	1	是	当pageNo为1时需要返回我的专题和热门专题
pageSize	每页行数	int	5	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 5,
  "total": 100,
  "data":{
    "mySpecial":{  //我的专题，如果没登陆，或者用户没关注，则不需要返回
      "authorID":"作者ID",
      "authorName":"作者名称",
      "authorUrl":"作者头像",
      "articleID":"文章id"
      "imageUrl":"文章图片",
      "title":"文章标题",
      "desc":"文章正文前xxx字",
      "newCount":"已更新文章数"
    },
    "hotSpecial":[  //热门二级专题，3个
      { 
        "secondarySpecialID":"专题ID",
        "secondarySpecialName":"专题名称",
        "articleCount":"文章篇数"
        "followCount":"关注人数",
        "imageUrl":"专题图片"
      },
      ......
    ],
    "specialList":[    //一级专题列表中包含最多4个二级专题
      {
        "specialID":"专题ID",
        "specialName":"专题名称",
        "secondaryCount":"二级专题总数量",
        "secondaryList":[
          { 
            "secondarySpecialID":"专题ID",
            "secondarySpecialName":"专题名称",
            "imageUrl":"焦点图片"
          },
          ......
        ]
      },
      ......
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
authorName	作者名称	authorID	作者ID
pageNo	一级专题的pageNo	pageSize	一级专题的pageSize
total	一级专题的总数	newCount	我的订阅中新文章数量

2.2专题主页

开发环境： http://dev15.pclady.com.cn/app/specialContentPage.jsp
线上环境： http://plastic.pclady.com.cn/app/specialContentPage.jsp
mrobot地址： http://mrobot.pclady.com.cn/specialContentPage.xsp

说明

获取指定专题的专题介绍栏、分类标签栏、内容列表
app不作缓存

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
secondarySpecialID	二级专题ID	string	""	否
common_session_id	太平洋通行证session	string	""	否	cookies中添加
pageNo	内容页数	int	1	是	为1时需要返回专题介绍栏、分类标签栏
pageSize	内容页数	int	20	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "data":{
    "introduce":{  //二级专题介绍栏
      "secondarySpecialID":"二级专题ID",
      "secondarySpecialName":"二级专题名称",
      "secondarySpecialText":"专题简介文本",
      "imageUrl":"专题图片",
    },
    "column":{  //分类标签栏  包含一篇最新文章
      "authorID":"作者ID",
      "authorName":"作者昵称",
      "authorUrl":"作者头像",
      "articleID":"文章id"
      "imageUrl":"文章图片",
      "title":"文章标题",
      "desc":"文章正文前xxx字",

      "articleCount":"专题文章篇数",
      "followCount":"专题关注人数",
      "authorCount":"专题作者人数"
    },
    "articleList":[    //专题中的内容列表，不包括分类标签栏中的那篇
      {
        "authorID":"作者ID",
        "authorName":"作者昵称",
        "authorUrl":"作者头像",
        "articleID":"文章id",
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字",
        "specialName":"所属一级专题名称"
      },
      ......
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
authorName	作者名称	authorID	作者ID
specialName	文章所属专题的分类名称
articleCount	该专题下的文章数量	followCount	该专题下的关注人数
authorCount	该专题下的作者人数

2.3所有专题页

开发环境： http://dev15.pclady.com.cn/app/secondarySpecialList.jsp
线上环境： http://plastic.pclady.com.cn/app/secondarySpecialList.jsp
mrobot地址： http://mrobot.pclady.com.cn/secondarySpecialList.xsp

说明

获取指定一级专题下的二级专题列表
app不作缓存

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须
specialID	一级专题id	string	""	是
pageNo	内容页数	int	1	是
pageSize	内容页数	int	15	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 15,
  "total": 100,
  "data":{
    "specialText":"一级专题的介绍文本",
    "specialList":[
      {
        "secondarySpecialID":"专题ID",
        "secondarySpecialName":"专题名称",
        "secondarySpecialText":"专题简介文本",
        "imageUrl":"专题图片",
        "articleCount":"文章篇数",
        "followCount":"关注人数"
      },
      ......
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
superSpecialDesc	一级专题的描述信息,显示在标题中
articleCount	该专题下的文章数量	followCount	该专题下的关注人数

2.4订阅专题

开发环境： http://dev15.pclady.com.cn/app/subscribeSpecial.jsp
线上环境： http://plastic.pclady.com.cn/app/subscribeSpecial.jsp

说明

登陆后订阅二级专题

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
secondarySpecialID	二级专题id	string	""	是
common_session_id	太平洋通行证session	string	""	是	cookies中添加

{
  "status":0,
  "msg":"已成功订阅"
}
{
  "status":0,
  "msg":"已取消订阅"
}

返回参数说明

参数名	参数含义	参数名	参数含意

2.5专题是否已被用户订阅

开发环境： http://dev15.pclady.com.cn/app/isSpecialSubscribed.jsp
线上环境： http://plastic.pclady.com.cn/app/isSpecialSubscribed.jsp
mrobot地址： http://mrobot.pclady.com.cn/isSpecialSubscribed.xsp

说明

获取该专题是否已被用户订阅

缓存时间

0分钟

提交方式

GET

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
secondarySpecialID	文章id	string	""	是
common_session_id	太平洋通行证session	string	""	是	cookies中添加

{
  "status":0,
  "msg":"请求成功",
  "hasSubscribed":"1"
}

返回参数说明

参数名	参数含义	参数名	参数含意
hasSubscribed	0：未订阅，1:已订阅

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/voteInfo.xsp

说明

投票详情页，应用端返回投票页详情，mrobot端组装wap页，评论数据从评论系统获取，参考 1.3文章评论列表

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动ID	string	""	是
activityType	活动类型	string	"1"	是	1：投票，2：话题
common_session_id	太平洋通行证session	string	""	否	cookies中添加
fmt	fmt=json 时显示接口数据	String	""	否
appVersion=	版本号	string	""	否
inReview=	1：审核状态 0：发布状态	int	0	否	ios审核时用到

{
  "status":0,
  "msg":"请求成功",
  "activityID":"活动ID",
  "activityType":"活动类型",
  "activityTitle":"活动标题",
  "activityDesc":"活动简介",
  "imageUrl":"活动图片",
  "totalCount":"参与人数",
  "isVoted":"是否已经投票",
  "optionList":[//投票选项、投票结果
    {
      "optionID":"选项ID",
      "optionTile":"选项标题",
      "optionImageUrl":"选项图片",
      "voteCount":"100"//投票人数
    },
    ......
  ]
}

mrobot返回的html中的json
{
  "collectCount":100,
  "commentCount":50
}

返回参数说明

参数名	参数含义	参数名	参数含意
collectCount	文章被收藏次数	commentCount	文章评论数量
isVoted	是否已经投票，0：否，1：是	totalCount	总参与人数，投票活动指的是参与投票的人数

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/topicInfo.xsp

说明

话题详情页，应用端返回话题页详情，mrobot端组装wap页，评论数据从评论系统获取，参考 1.3文章评论列表

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动ID	string	""	是
activityType	活动类型	string	"2"	是	1：投票，2：话题
common_session_id	太平洋通行证session	string	""	否	cookies中添加
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/vote.jsp
线上环境： http://plastic.pclady.com.cn/app/vote.jsp

说明

在投票详情页中投票

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动id	string	""	是
optionID	选项id	string	""	是
deviceID	设备ID	string	""	是	设备id
common_session_id	太平洋通行证session	string	""	否	cookies中添加，登陆了就传

{
  "status":0,
  "msg":"投票成功"
}
{
  "status":-1,
  "msg":"不能重复投票"
}

返回参数说明

参数名	参数含义	参数名	参数含意

3.5收藏活动

开发环境： http://dev15.pclady.com.cn/app/collectActivity.jsp
线上环境： http://plastic.pclady.com.cn/app/collectActivity.jsp

说明

收藏或取消收藏指定活动，根据type区分

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动id	string	""	是
type	操作类型	int	""	是	1：收藏，2：取消收藏
common_session_id	太平洋通行证session	string	""	是	cookies中添加

{
  "status":0,
  "msg":"收藏成功"
}
{
  "status":0,
  "msg":"取消收藏成功"
}
{
  "status":-1,
  "msg":"错误原因"
}

返回参数说明

参数名	参数含义	参数名	参数含意

3.6活动是否被用户收藏

开发环境： 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	""	是	cookies中添加

{
  "status":0,
  "msg":"请求成功",
  "hasCollected":"1"
}

返回参数说明

参数名	参数含义	参数名	参数含意
hasCollected	0：未收藏，1:已收藏

4.自媒体

4.1自媒体列表

开发环境： http://dev15.pclady.com.cn/app/authorList.jsp
线上环境： http://plastic.pclady.com.cn/app/authorList.jsp
mrobot地址： http://mrobot.pclady.com.cn/authorList.xsp

说明

读取所有自媒体列表

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
pageNo	页数	int	1	是
pageSize	页面大小	int	40	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 40,
  "total": 100,
  "data":[
    {
      "authorID":"作者ID",
      "authorName":"作者名称",
      "authorWXID":"作者微信公众号",
      "authorUrl":"作者头像",
      "desc":"简介",
    },
    ......
  ]
}

返回参数说明

参数名	参数含义	参数名	参数含意
authorName	作者名称	authorID	作者ID

4.2自媒体主页

()

开发环境： http://dev15.pclady.com.cn/app/authorIndex.jsp
线上环境： http://plastic.pclady.com.cn/app/authorIndex.jsp
mrobot地址： http://mrobot.pclady.com.cn/authorIndex.xsp

说明

获取指定自媒体的主页信息

缓存时间

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":"作者微信公众号",
        "authorImage":"作者头像",
        "desc":"简介",
        "supportCount":"点赞数",
        "opposeCount":"反对数"
    },
    "articleList":[
      { 
        "specialID":"所属一级专题ID",
        "specialName":"所属一级专题名称",
        "authorID":"作者ID",
        "authorName":"作者名称",
        "authorImage":"作者头像",
        "articleID":"文章id"
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字"
      },
      ......
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
authorName	作者名称	authorID	作者ID

5.个人中心

5.1修改昵称

开发环境： http://dev15.pclady.com.cn/app/syncNickName.jsp
线上环境： http://plastic.pclady.com.cn/app/syncNickName.jsp

说明

修改昵称

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
nickName	昵称	string	""	是	mrobot转义
common_session_id	太平洋通行证session	string	""	是	cookies中添加

{
  "status":0,
  "msg":"请求成功",
}

返回参数说明

参数名	参数含义	参数名	参数含意
status	返回状态

5.2修改头像

url： http://upc.pconline.com.cn/upload_head.jsp

说明

修改头像

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
common_session_id	太平洋通行证session	string	""	是	cookies中添加
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	""	是	cookies中添加
type	类型	int		是	0：文章 1：活动

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "data":[
    { 
      "specialID":"专题ID",
      "specialName":"专题名称",
      "authorID":"作者ID",
      "authorName":"作者名称",
      "authorUrl":"作者头像",
      "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	""	是	cookies中添加
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	""	是	cookies中添加
pageNo	页码	int	1	是
pageSize	每页行数	int	20	是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "data":[
    { 
      "specialID":"专题ID",
      "specialName":"专题名称",
      "authorID":"作者ID",
      "authorName":"作者名称",
      "authorUrl":"作者头像",
      "articleID":"文章id"
      "imageUrl":"文章图片",
      "title":"文章标题",
      "desc":"文章正文前xxx字"
      "datetime":"YYYY-MM-DD HH:mm:ss"
    },
    ......
  ]
}

返回参数说明

参数名	参数含义	参数名	参数含意
datetime	文章的更新时间

6.其它

6.1启动上报

开发环境： http://dev15.pclady.com.cn/app/reportStartUp.jsp
线上环境： http://plastic.pclady.com.cn/app/reportStartUp.jsp

说明

当天用户第一次启动时，需要上报一次。便于判断活跃度

缓存时间

0

提交方式

POST

是否登录

是

数据来源

整形库编辑后台

参数

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

{
  "status":0,
  "msg":"请求成功"
}

返回参数说明

参数名	参数含义	参数名	参数含意

6.2新增用户

开发环境： http://dev15.pclady.com.cn/app/addUser.jsp
线上环境： http://plastic.pclady.com.cn/app/addUser.jsp

说明

注册成功后，通知平台添加用户和积分

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
r	时间截	String	""	是
sign	MD5加密串	String	""	是
type	类型	String	""	否	1:qq,2:微信,3:新浪
nickName	昵称	String	""	否

{
  status:0,
  msg:”请求成功”
}

Download in other formats:

Plain Text

Context Navigation

Table of Contents

时尚胶囊2.0.0接口文档

1.首页

1.1资讯首页

1.2文章终端页 （WEB）

1.3文章评论列表

1.4标签文章列表

1.5焦点页点赞、踩

1.6文章点赞、踩

1.7评论点赞

1.8评论发送

1.9收藏文章

1.10焦点图点赞、踩状态查询

1.11文章是否被用户收藏

2.专题

2.1专题频道页

2.2专题主页

2.3所有专题页

2.4订阅专题

2.5专题是否已被用户订阅

3.互动

3.1活动频道页

3.2投票活动详情页（WEB）

3.3话题活动详情页（WEB）

3.4投票

3.5收藏活动

3.6活动是否被用户收藏

4.自媒体

4.1自媒体列表

4.2自媒体主页

5.个人中心

5.1修改昵称

5.2修改头像

5.3我的收藏

5.4我的订阅（专题）

5.5我的订阅（更新）

6.其它

6.1启动上报

6.2新增用户

Download in other formats:

1.2文章终端页（WEB）