wiki:pclady_news2.0.0_api

Context Navigation

Version 22 (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）
ps:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能）
参考电脑网评论接口
 参考聚超值评论接口

1.首页

1.1资讯首页

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

说明

获取资讯栏目的首页精选数据，文章由后台人工录入，录入时选择是否在首页露出，以及露出的位置（前15位），如果没有选择露出位置则添加在列表顶部。
此列表中的文章数据按天进行分组，每次返回的数据为某一天的文章数据，参数中用day来标识，day为0时代表读取当天的数据，day为1时代表读取昨天数据，以此类推。
列表中的文章按5横2短的样式循环排序

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
day	指定天数	int	0	是	为0时返回当天的，1为昨天的，2为前天的，以此类推
deviceID	设备ID	string			根据设备号判定是否点赞或踩过焦点图

{
  "status":0,
  "msg":"请求成功",
  "data":{
    "focus":{
      "imageUrl":"焦点图片",
      "focusID":"焦点图ID"
      "title":"焦点图标题",
      "guide":"焦点图导读文字",
      "focusDate":"焦点日期"//YYYY-MM-DD,
      "hasLaud":"1"
    },
    "articleList":[
      { 
        "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:短图样式

1.2文章终端页（未完成）

获取文章终端页 ()
开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
mrobot地址：

说明

获取指定文章终端页的内容

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
articleId	文章ID	string	""	是

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


  }
}

返回参数说明

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

1.3文章评论列表

(经评论系统)
开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
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	""	是

{
    "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

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

是否登录

否

数据来源

编辑后台

参数

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

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "data":{
    "articleList":[
      { 
        "userID":"用户ID",
        "nickName":"用户昵称",
        "articleID":"文章ID",
        "title":"文章标题",
        "articleID":"文章ID",
        "imageUrl":"文章图片"
      }
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户ID

1.5焦点页点赞、踩

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

说明

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

缓存时间

0分钟

提交方式

POST

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
focusID	焦点图ID	string	""	是
sp	操作类型	string	""	是	1：点赞，2：踩
deviceID	设备ID	string	""	是	根据设备号判定（是否需要与评论点赞的保持一致？）

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

返回参数说明

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

1.6评论点赞

经评论系统
url： http://cmt.pclady.com.cn/action/comment/support_json.jsp[[BR]]

说明

对评论进行点赞

缓存时间

0分钟

提交方式

POST

是否登录

否

数据来源

参数

参数名	参数含义	类型	默认值	是否必须	说明
cid	评论ID	string	""	是
sp	点赞操作	string	""	是	>0代表点赞，<=0代表反对

        {
            "support": 2,
            "floor": 2,
            "status": 0,
            "topicId": 13205153,
            "postId": 36813920
        }
        
        {
            message: "您已对该评论投过票，不可重复投票",
            status: -1
        }

返回参数说明

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

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	""	否

{
    "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
}

返回参数说明

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

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":"专题名称",
      "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	我的订阅中新文章数量

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":{  //分类标签栏  包含一篇最新文章
      "userID":"用户ID",
      "nickName":"用户昵称",
      "articleID":"文章id"
      "imageUrl":"文章图片",
      "title":"文章标题",
      "desc":"文章正文前xxx字",
      "articleCount":"文章篇数",
      "followCount":"关注人数",
      "authorCount":"作者人数"
    },
    "articleList":[    //专题中的内容列表，不包括分类标签栏中的那篇
      {
        "userID":"用户ID",
        "nickName":"用户昵称",
        "articleID":"文章id",
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字",
        "superSpecialName":"所属一级专题名称",
        "style":"1"
      },
      ......
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户ID
superSpecialName	文章所属专题的分类名称	style	文章样式：1为横样式，2为小样式
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字"
      },
      ......
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户ID

3.2活动详情页（投票）

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

说明

投票详情页

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动ID	int	1	是

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


  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户ID

3.3活动详情页（话题）

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

说明

话题详情页

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
activityID	活动ID	int	1	是

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

  }
}

返回参数说明

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

4.自媒体

4.1自媒体列表

()
/author.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":{
    "authorList":[
      {
        "authorID":"作者ID",
        "authorName":"作者昵称",
        "authorWXID":"作者微信号",
        "imageUrl":"作者头像",
        "desc":"简介",
      }
    ]
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户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		是

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 40,
  "total": 100,
  "data":{
    "author":{
        "authorID":"作者ID",
        "authorName":"作者昵称",
        "authorWXID":"作者微信号",
        "imageUrl":"作者头像",
        "desc":"简介",
        "useful":"点赞数",
        "unuseful":"反对数"
    },
    "articleList":[
      { 
        "specialID":"专题ID",
        "specialName":"专题名称",
        "userID":"用户ID",
        "nickName":"用户昵称",
        "articleID":"文章id"
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字",
        "style":"1"
      }
  }
}

返回参数说明

参数名	参数含义	参数名	参数含意
nickName	用户昵称	userID	用户ID
style	文章样式，此列表下文章样式都为小图样式

Download in other formats:

Plain Text

Context Navigation

Table of Contents

时尚胶囊2.0.0接口文档

1.首页

1.1资讯首页

1.2文章终端页（未完成）

1.3文章评论列表

1.4标签文章列表

1.5焦点页点赞、踩

1.6评论点赞

1.7评论发送

2.专题

2.1专题频道页

2.2专题主页

2.3所有专题页

2.4订阅专题页

3.互动

3.1活动频道页

3.2活动详情页（投票）

3.3活动详情页（话题）

4.自媒体

4.1自媒体列表

4.2自媒体主页

Download in other formats: