[[TOC]] = 时尚胶囊2.0.0接口文档 = >mrobot代理环境说明： 192.168.10.198：1080(192.168.74.80)[[BR]] 192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] ps:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能） [[BR]] [http://rdtrac.pc.com.cn/cmt/wiki/intf "参考电脑网评论接口"][[BR]] [http://trac.pc.com.cn/iphone/wiki/price_jiekou "参考聚超值评论接口"][[BR]] [http://192.168.33.97/app%E5%89%8D%E5%8F%B0/index.html#p=版本说明 "框架"][[BR]] [http://192.168.50.171/2015/2015-12-02/index.html "设计稿地址"][[BR]] == 1.首页 == ---------- === 1.1资讯首页 === 开发环境：http://dev15.pclady.com.cn/app/dayArticles.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/dayArticles.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/dayArticles.xsp **说明** > 获取资讯栏目的首页精选数据。[[BR]] > 列表中的文章数据按天（服务器时间）进行分页，每次返回的数据为某一天的文章数据，参数中用date来标识，如果date为空表示加载当天数据，随后后端返回数据时需要一同返回这些数据是属于哪天的，以及有数据的下一天的日期nextDate。[[BR]] > 数据异常机制：当天必须要有焦点文章，如果没有焦点文章，即使有文章数据也跳过该天，随后返回最近有焦点文章那天的文章列表。 **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||date||指定日期||string||""||否||= 为空时返回服务器当天数据，随后使用后端返回的数据来请求，格式YYYY-MM-DD =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "data":{ "date":"数据所属日期",//YYYY-MM-DD "nextDate":"下次请求的日期",//YYYY-MM-DD "focusArtical":{ //焦点文章 "focusID":"焦点图ID", "imageUrl":"焦点图片", "desc":"焦点图简介", "hasLaud":"1" }, "articleList":[ { "specialID":"所属一级专题ID", "specialName":"所属一级专题名称", "authorID":"作者ID", "authorName":"作者昵称", "authorUrl":"作者头像", "articleID":"文章id" "imageUrl":"文章图片", "title":"文章标题", "desc":"文章正文前xxx字" } ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= authorName =||= 作者昵称 =||= authorID =||= 作者ID =|| ||= focusDate =||= 焦点图上显示的时间 =||= hasLaud =||= 焦点图点赞情况，0为既没点赞也没踩，1为点赞过了，2为踩过了 =|| [[BR]] === 1.2文章终端页 （WEB）=== 开发环境：http://dev15.pclady.com.cn/app/articleInfo.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/articleInfo.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/article.xsp **说明** > 获取指定文章终端页的内容 [[BR]] > 应用端出相关数据与文章html，wap页由mrobot来完成，评论数据从评论系统获取，参考 [http://rdtrac.pc.com.cn/iphone/wiki/pclady_news2.0.0_api#a1.3文章评论列表 "1.3文章评论列表"] [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= articleID =||= 文章ID =||= string =||= "" =||= 是 =||= =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 否 =||= =|| ||= fmt =||= fmt=json 时显示接口数据=||=String=||=""=||=否=||= =|| ||= appVersion= ||=版本号=||=string=||=""=||= 否 =||= =|| ||= inReview= ||=1：审核状态 0：发布状态=||=int=||= 0 =||= 否 =||=ios审核时用到 =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "articleID":"文章ID", "authorID":"作者ID", "authorName":"作者昵称", "authorUrl":"作者头像", "authorWXID":"作者微信订阅号", "headImageUrl":"文章头图", "title":"文章标题", "collectCount":100, "supportCount":100, "opposeCount":50, "sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss", "html":"文章html文本", "css":"样式文本",//看后端怎么保存文章的，html和css、js等放一起也可以 "specialList":[ {//相关专题 "specialID":"专题ID", "specialName":"专题名称", "introduceText":"专题简介文本", "imageUrl":"专题图片", "articleCount":"文章篇数", "followCount":"关注人数" }, ...... ], "tagList":[ { "tagID":"标签ID", "tagText":"标签文本" }, ...... ] } mrobot返回的html中的json { "collectCount":100, "commentCount":50 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= collectCount =||= 文章被收藏次数 =||= commentCount =||= 文章评论数量 =|| [[BR]] === 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 =|| ||= articleId =||= 文章ID =||= string =||= "" =||= 是 =||= =|| ||= reverse =||= 排序方式 =||= string =||= "" =||= 是 =||= 0 倒序； 1 正序 =|| **返回** {{{#!java { "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 =|| [[BR]] === 1.4标签文章列表 === '''()'''[[BR]] /tagArticles.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 点击标签后，获取带有该关键字的文章列表，app不作缓存[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||tagID||标签ID||string|| ||是||= =|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||20||是||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data":{ "articleList":[ { "authorID":"作者ID", "authorName":"作者名称", "authorUrl":"作者头像", "articleID":"文章ID", "title":"文章标题", "articleID":"文章ID", "imageUrl":"文章图片" } ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= authorID =||= 作者ID =||= authorName =||= 作者名称 =|| [[BR]] === 1.5焦点页点赞、踩 === /supportFocus.jsp 开发环境：http://dev15.pclady.com.cn/app/supportFocus.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/supportFocus.jsp [[BR]] **说明** > 对焦点页进行点赞或踩。如果焦点页未被赞、踩，那么则对焦点页进行赞、踩操作。如果已赞或已踩，则切换赞、踩状态，不能取消点赞或取消踩 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= focusID =||=焦点图ID =||= string =||= "" =||= 是 =||= =|| ||= sp =||=操作类型=||= string =||= "" =||= 是 =||=1：点赞，2：踩 =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 否 =||= 如果登陆了就传 =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= 根据设备号判定（是否需要与评论点赞的保持一致？） =|| **返回** {{{#!java { "status":0, "msg":"请求成功" } { "status":1, "msg":"您已经赞过了，不能重复点赞" } { "status":2, "msg":"您已经踩过了，不能重复踩" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.6文章点赞、踩 === 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] **说明** > 对文章页进行点赞或踩。如果文章页未被赞、踩，那么则文章点页进行赞、踩操作。如果已赞或已踩，则切换赞、踩状态，但不能重复点赞或重复踩。 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= focusID =||=焦点图ID =||= string =||= "" =||= 是 =||= =|| ||= sp =||=操作类型=||= string =||= "" =||= 是 =||=1：点赞，2：踩 =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 否 =||= 如果登陆了就传 =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= 根据设备号判定（是否需要与评论点赞的保持一致？） =|| **返回** {{{#!java { "status":0, "msg":"您对文章表态成功" } { "status":1, "msg":"您已经对文章表态过了" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.7评论点赞 === 经评论系统[[BR]] url：http://cmt.pclady.com.cn/action/comment/support_json.jsp [[BR]] **说明** > 对评论进行点赞 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 否 **数据来源** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= cid =||= 评论ID =||= string =||= "" =||= 是 =||= =|| ||= sp =||=点赞操作=||= string =||= "" =||= 是 =||= >0代表点赞 ，<=0代表反对 =|| **返回** {{{#!java { "support": 2, "floor": 2, "status": 0, "topicId": 13205153, "postId": 36813920 } { message: "您已对该评论投过票，不可重复投票", status: -1 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.8评论发送 === 经评论系统[[BR]] 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 =||= "" =||= 否 =||= =|| **返回** {{{#!java { "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 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.9收藏文章 === 开发环境：http://dev15.pclady.com.cn/app/collectArticle.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/collectArticle.jsp [[BR]] **说明** > 收藏或取消收藏指定文章，根据参数type区分[[BR]] **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= articleID =||= 文章id =||= string =||= "" =||= 是 =||= =|| ||= type =||= 操作类型 =||= int =||= "" =||= 是 =||= 1：收藏 ，2：取消收藏 =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"已成功收藏" } { "status":1, "msg":"已取消收藏" } { "status":-1, "msg":"错误原因" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.10焦点图点赞、踩状态查询 === 开发环境：http://dev15.pclady.com.cn/app/focusSupportState.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/focusSupportState.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/focusSupportState.xsp **说明** > 查询某设备或用户对某焦点图的点赞、踩状态[[BR]] **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= focusID =||= 焦点图id =||= string =||= "" =||= 是 =||= =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 是 =||= =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= 根据设备号判定（是否需要与评论点赞的保持一致？） =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "data":{ "state":"0" } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= state =||= 0：未点赞未踩，1：已点赞，2：已踩 =||= =||= =|| [[BR]] === 1.11文章是否被用户收藏 === 开发环境：http://dev15.pclady.com.cn/app/isArticleCollected.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/isArticleCollected.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/isArticleCollected.xsp **说明** > 获取该文章是否已被用户收藏[[BR]] **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= articleID =||= 文章id =||= string =||= "" =||= 是 =||= =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "hasCollected":"1" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= hasCollected =||= 0：为收藏，1:已收藏 =||= =||= =|| ---------- == 2.专题 == ---------- === 2.1专题频道页 === '''()'''[[BR]] /specialIndex.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 获取专题首页中我的专题、热门专题、其他专题列表[[BR]] > 我的专题中显示我订阅专题内最新更新的一篇文章，以及自上一次进入我的订阅页面后累计更新的文章数，若用户无订阅任何专题或未登录，不需要返回此节点[[BR]] > 热门专题列表读取后台中设定的3个热门专题 [[BR]] > 其他专题列表读取后台中设定的专题，若干个一级专题，一级专题下有4个露出二级专题 [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否/是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 否 =||= =|| ||= pageNo =||= 页码 =||= int =||= 1 =||= 是 =||= 当pageNo为1时需要返回我的专题和热门专题 =|| ||= pageSize =||= 每页行数 =||= int =||= 5 =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 5, "total": 100, "data":{ "mySpecial":{ //我的专题，如果没登陆，或者用户没关注，则不需要返回 "authorID":"作者ID", "authorName":"作者名称", "authorUrl":"作者头像", "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 =||= 我的订阅中新文章数量 =|| [[BR]] === 2.2专题主页 === 开发环境：http://dev15.pclady.com.cn/app/specialContentPage.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/specialContentPage.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/specialContentPage.xsp **说明** > 获取指定专题的专题介绍栏、分类标签栏、内容列表 [[BR]] > app不作缓存 [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= specialID =||= 二级专题ID =||= string =||= "" =||= 否 =||= =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 否 =||= =|| ||= pageNo =||= 内容页数 =||= int =||= 1 =||= 是 =||= 为1时需要返回专题介绍栏、分类标签栏 =|| ||= pageSize =||= 内容页数 =||= int =||= 20 =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data":{ "specialIntroduce":{ //专题介绍栏 "specialID":"专题ID", "specialName":"专题名称", "introduceText":"专题简介文本", "imageUrl":"专题图片", }, "specialColumn":{ //分类标签栏 包含一篇最新文章 "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 =|| ||= superSpecialName =||= 文章所属专题的分类名称 =||= =||= =|| ||= articleCount =||= 该专题下的文章数量 =||= followCount =||= 该专题下的关注人数 =|| ||= authorCount =||= 该专题下的作者人数 =||= =||= =|| [[BR]] === 2.3所有专题页 === 开发环境：http://dev15.pclady.com.cn/app/secondarySpecialList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/secondarySpecialList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/secondarySpecialList.xsp **说明** > 获取指定一级专题下的二级专题列表 [[BR]] > app不作缓存 [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= specialID =||= 一级专题id =||= string =||= "" =||= 是 =||= =|| ||= pageNo =||= 内容页数 =||= int =||= 1 =||= 是 =||= =|| ||= pageSize =||= 内容页数 =||= int =||= 15 =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 15, "total": 100, "data":{ "specialDesc":"一级专题的描述信息", "specialList":[ { "specialID":"专题ID", "specialName":"专题名称", "introduceText":"专题简介文本", "imageUrl":"专题图片", "articleCount":"文章篇数", "followCount":"关注人数" }, ...... ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= superSpecialDesc =||= 一级专题的描述信息,显示在标题中 =||= =||= =|| ||= articleCount =||= 该专题下的文章数量 =||= followCount =||= 该专题下的关注人数 =|| [[BR]] === 2.4订阅专题页 === 开发环境：http://dev15.pclady.com.cn/app/subscribeSpecial.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/subscribeSpecial.jsp [[BR]] **说明** > 登陆后订阅专题页 [[BR]] **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= specialID =||= 专题id =||= string =||= "" =||= 是 =||= =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"已成功订阅" } { "status":0, "msg":"已取消订阅" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] == 3.互动 == ---------- === 3.1活动频道页 === '''()'''[[BR]] /activityList.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 读取活动列表，20条一组 > app不做缓存[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||20||是||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data":{ "activityList":[ { "activityID":"活动ID", "activityName":"活动名称", "activityType":"活动类型", "userCount":"参与用户人数", "data":"活动发布日期" "imageUrl":"活动图片", "desc":"活动简介前25字" }, ...... ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= activityType =||= 1：投票，2：话题 =||= =||= =|| [[BR]] === 3.2投票活动详情页（WEB） === 开发环境：http://dev15.pclady.com.cn/app/voteInfo.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/voteInfo.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/vote.xsp **说明** > 投票详情页，应用端返回投票页详情，mrobot端组装wap页，评论数据从评论系统获取，参考 [http://rdtrac.pc.com.cn/iphone/wiki/pclady_news2.0.0_api#a1.3文章评论列表 "1.3文章评论列表"] [[BR]] **缓存时间** >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审核时用到 =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "activityID":"活动ID", "activityType":"活动类型", "activityTitle":"活动标题", "activityDesc":"活动简介", "imageUrl":"活动图片", "userCount":"参与人数", "optionList":[//投票选项 { "optionID":"选项ID", "optionTile":"选项标题", "optionImageUrl":"选项图片" }, ...... ] } mrobot返回的html中的json { "collectCount":100, "commentCount":50 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= collectCount =||= 文章被收藏次数 =||= commentCount =||= 文章评论数量 =|| [[BR]] === 3.3话题活动详情页（WEB） === 开发环境：http://dev15.pclady.com.cn/app/topicInfo.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/topicInfo.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/topic.xsp **说明** > 话题详情页，应用端返回话题页详情，mrobot端组装wap页，评论数据从评论系统获取，参考 [http://rdtrac.pc.com.cn/iphone/wiki/pclady_news2.0.0_api#a1.3文章评论列表 "1.3文章评论列表"] [[BR]] **缓存时间** >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审核时用到 =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "activityID":"活动ID", "activityType":"活动类型", "activityTitle":"活动标题", "activityDesc":"活动简介", "imageUrl":"活动图片", "userCount":"参与人数", "html":"话题正文html" } mrobot返回的html中的json { "collectCount":100, "commentCount":50 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= collectCount =||= 文章被收藏次数 =||= commentCount =||= 文章评论数量 =|| [[BR]] === 3.4收藏活动 === 开发环境：http://dev15.pclady.com.cn/app/collectActivity.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/collectActivity.jsp [[BR]] **说明** > 收藏或取消收藏指定活动，根据type区分[[BR]] **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= activityID =||= 活动id =||= string =||= "" =||= 是 =||= =|| ||= type =||= 操作类型 =||= int =||= "" =||= 是 =||= 1：收藏 ，2：取消收藏 =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"已成功收藏" } { "status":0, "msg":"已取消收藏" } { "status":-1, "msg":"错误原因" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 3.5活动是否被用户收藏 === 开发环境：http://dev15.pclady.com.cn/app/isActivityCollected.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/isActivityCollected.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/isActivityCollected.xsp **说明** > 获取该活动是否已被用户收藏[[BR]] **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= activityID =||= 活动id =||= string =||= "" =||= 是 =||= =|| ||= common_session_id =||= 太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "hasCollected":"1" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= hasCollected =||= 0：未收藏，1:已收藏 =||= =||= =|| [[BR]] == 4.自媒体 == ---------- === 4.1自媒体列表 === '''()'''[[BR]] /authorList.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 读取所有自媒体列表[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||40||是||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 40, "total": 100, "data":[ { "authorID":"作者ID", "authorName":"作者名称", "authorWXID":"作者微信公众号", "authorUrl":"作者头像", "desc":"简介", }, ...... ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= authorName =||= 作者名称 =||= authorID =||= 作者ID =|| [[BR]] === 4.2自媒体主页 === '''()'''[[BR]] /authorIndex.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 获取指定自媒体的主页信息[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||authorID||自媒体ID||int|| ||是||= =|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||20||是||= =|| **返回** {{{#!java { "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 =|| [[BR]] == 5.个人中心 == ---------- === 5.1修改昵称 === 开发环境：http://dev15.pclady.com.cn/app/syncNickName.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/syncNickName.jsp [[BR]] **说明** > 修改昵称[[BR]] **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| || nickName ||昵称||string||""||是||= =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= status =||=返回状态=||= =||= =|| [[BR]] === 5.2修改头像 === url：http://upc.pconline.com.cn/upload_head.jsp **说明** > 修改头像[[BR]] **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| || form-data ||二进制图片数据|| ||||是||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= status =||= 返回状态 =||= =||= =|| [[BR]] === 5.3我的收藏 === /myCollection.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 获取我的收藏列表，分为文章与活动两种[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= pageNo =||= 页码 =||= int =||= 1 =||= 是 =||= =|| ||= pageSize =||= 每页行数 =||= int =||= 20 =||= 是 =||= =|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| ||= type =||= 类型 =||= int =||= =||= 是 =||= 0：文章 1：活动 =|| **返回** {{{#!java { "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 =||= 返回状态 =||= =||= =|| [[BR]] === 5.4我的订阅（专题） === /subscribedSpecialList.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 获取用户已订阅的专题列表[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| ||= pageNo =||= 页码 =||= int =||= 1 =||= 是 =||= =|| ||= pageSize =||= 每页行数 =||= int =||= 20 =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "specialList":[ { "specialID":"专题ID", "specialName":"专题名称", "introduceText":"专题简介文本", "imageUrl":"专题图片", "articleCount":"文章篇数", "followCount":"关注人数" }, ...... ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= status =||= 返回状态 =||= =||= =|| [[BR]] === 5.5我的订阅（更新） === /subscribedArticleList.jsp [[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/ **说明** > 获取我的订阅中自订阅时间起更新的所有文章[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| ||= pageNo =||= 页码 =||= int =||= 1 =||= 是 =||= =|| ||= pageSize =||= 每页行数 =||= int =||= 20 =||= 是 =||= =|| **返回** {{{#!java { "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 =||= 文章的更新时间 =||= =||= =|| [[BR]] == 6.协议约定 == ----------