[[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 "参考聚超值评论接口"] == 1.首页 == ---------- === 1.1资讯首页 === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] /dayArticles.jsp 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/index.xsp **说明** > 获取资讯栏目的首页精选数据，文章由后台人工录入，录入时选择是否在首页露出，以及露出的位置（前15位），如果没有选择露出位置则添加在列表顶部。 > 此列表中的文章数据按天进行分组，每次返回的数据为某一天的文章数据，参数中用day来标识，day为0时代表读取当天的数据，day为1时代表读取昨天数据，以此类推。[[BR]] > 列表中的文章按5横2短的样式循环排序 [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||day||指定天数||int||0||是||= 为0时返回当天的，1为昨天的，2为前天的，以此类推 =|| ||deviceID||设备ID||string|| || ||= 根据设备号判定是否点赞或踩过焦点图 =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "data":{ "focus":{ "imageUrl":"焦点图片", "focusID":"焦点图ID" "title":"焦点图标题", "guide":"焦点图导读文字", "focusDate":"焦点日期"//YYYY-MM-DD, "hasLaud":"1" }, "articles":[ { "specialID":"专题ID", "specialName":"专题名称", "userID":"用户ID", "nickName":"用户昵称", "articleID":"文章id" "imageUrl":"文章图片", "title":"文章标题", "desc":"文章正文前xxx字", "style":"1" } ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= nickName =||= 用户昵称 =||= userID =||= 用户ID =|| ||= focusDate =||= 焦点图上显示的时间 =||= hasLaud =||= 焦点图点赞情况，0为既没点赞也没踩，1为点赞过了，2为踩过了 =|| ||= style =||= 文章样式 1:横图样式 2:短图样式 =||= =||= =|| [[BR]] === 1.2文章终端页（未完成） === 获取文章终端页 '''(mrobot已完成，请连开发机进行测试)'''[[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： **说明** > 获取指定文章终端页的内容 [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= articleId =||= 文章ID =||= string =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "data":{ } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.3文章评论列表 === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/v3/cmt/new_topics/13307019?articleId=6111016&pageSize=20&pageNo=1&reverse=0 mrobot地址： http://mrobot.pconline.com.cn/v3/cmt/new_topics **说明** > 获取文章评论列表，走评论系统，参考电脑网：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 =||= "" =||= 是 =||= 一般来说和articleId一样，如果获取文章时有返回此参数，就用该参数，没有的话就用articleId =|| ||= articleId =||= 文章ID =||= string =||= "" =||= 是 =||= =|| ||= reverse =||= 排序方式 =||= string =||= "" =||= 是 =||= 0 倒序； 1 正序 =|| ||= pageNo =||= 页码 =||= int =||= "" =||= 是 =||= =|| ||= pageSize =||= 每页行数 =||= int =||= "" =||= 是 =||= =|| **返回** {{{#!java { "comments": [ { "1": { "client": "2", "content": "一加总说自己不是oppo的儿子，拿你爹的衣服改改你确实也能穿，全是靠oppo的支持还跑出来谈独立。", "face": "http://i7.3conline.com/images/upload/upc/face/81/37/03/3/8137033_50x50", "floor": "46", "from": "来自Android客户端网友", "id": "39202998", "name": "guohuang16888", "time": "2015-02-07 08:54:56", "userId": "8137033" }, "2": { "client": "6", "content": "其实吧，他能提供优秀的硬件与服务对我们消费者来说就够了，一加是谁的儿子关我们体验什么事", "face": "http://i7.3conline.com/images/upload/upc/face/0/0_50x50", "floor": "47", "from": "来自PConline触屏版", "id": "39203202", "name": "广东省广州市网友", "time": "2015-02-07 10:21:50", "userId": "0" }, ...... "current": "6", "expand": false, "support": "1" }, ...... ], "docUrl": "http://mrobot.pconline.com.cn/v3/cms/articles/6111016", ], "pageCount": 4, "pageNo": 1, "total": 75 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= nickName =||= 用户昵称 =||= userID =||= 用户ID =|| [[BR]] === 1.4标签文章列表 === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] /app/tagArticles.jsp 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/ **说明** > 点击标签后，获取带有该关键字的文章列表，app不作缓存[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||tag||标签||string|| ||是||= =|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||20||是||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data":{ "articles":[ { "userID":"用户ID", "nickName":"用户昵称", "articleID":"文章ID", "title":"文章标题", "articleID":"文章ID", "imageUrl":"文章图片" } ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= nickName =||= 用户昵称 =||= userID =||= 用户ID =|| [[BR]] === 1.5焦点页点赞、踩 === 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] **说明** > 对焦点页进行点赞或踩，如果焦点页未赞、踩，那么则对焦点页进行赞、踩操作，如果已赞或已踩，则切换赞、踩状态 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 否 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= focusID =||=焦点图ID =||= string =||= "" =||= 是 =||= =|| ||= sp =||=操作类型=||= string =||= "" =||= 是 =||=1：点赞，2：踩 =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= 根据设备号判定（是否需要与评论点赞的保持一致？） =|| **返回** {{{#!java { "status":0, "msg":"请求成功" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| [[BR]] === 1.6评论点赞 === 评论系统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.7评论发送 === 评论系统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 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ---------- == 2.专题 == ---------- === 2.1专题首页 === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] /specialIndex.jsp 开发环境：http://dev15.pclady.com.cn/app/ [[BR]] 线上环境：http://plastic.pclady.com.cn/app/ [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/ **说明** > 获取专题首页中我的专题、热门专题、其他专题列表 > 我的专题中显示我订阅专题内最新更新的一篇文章，以及自上一次进入我的订阅页面后累计更新的文章数，若用户无订阅任何专题或未登录，隐藏我的专题[[BR]] > 热门专题列表读取后台中设定的热门专题（固定3个？） [[BR]] > 其他专题列表读取后台中设定的专题，若干个一级专题，一级专题下有4个露出二级专题（固定4个？） [[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否/是 **数据来源** >编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= common_session_id =||=太平洋通行证session =||= string =||= "" =||= 是 =||= =|| ||= pageNo =||= 页码 =||= int =||= "" =||= 是 =||= =|| ||= pageSize =||= 每页行数 =||= int =||= "" =||= 是 =||= =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 5, "total": 100, "data":{ "mySpecial":{ //我的专题，可为空 "specialID":"专题ID", "specialName":"专题名称", "userID":"用户ID", "nickName":"用户昵称", "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":"焦点图片" }, ...... ] }, ...... ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= nickName =||= 用户昵称 =||= userID =||= 用户ID =|| ||= pageNo =||= 一级专题的pageNo =||= pageSize =||= 一级专题的pageSize =|| ||= total =||= 一级专题的总数 =||= newCount =||= 我的订阅中新文章数量 =|| [[BR]]