wiki:pclady_news2.0.0_api

Version 18 (modified by hezhenwei1, 10 years ago) (diff)

--

Table of Contents

  1. 1.首页
    1. 1.1资讯首页
    2. 1.2文章终端页（未完成）
    3. 1.3文章评论列表
    4. 1.4标签文章列表
    5. 1.5焦点页点赞、踩
    6. 1.6评论点赞
    7. 1.7评论发送
  2. 2.专题
    1. 2.1专题首页

时尚胶囊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资讯首页

(mrobot已完成，请连开发机进行测试)
/dayArticles.jsp 开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
mrobot地址：  http://mrobot.pclady.com.cn/s-900/yimei/cms/index.xsp

说明

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

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

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

返回 

{
  "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:短图样式


1.2文章终端页（未完成）

获取文章终端页 (mrobot已完成，请连开发机进行测试)
开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
mrobot地址：

说明

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

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

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

返回 

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


  }
}

返回参数说明

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


1.3文章评论列表

(mrobot已完成，请连开发机进行测试)
开发环境： 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标签文章列表

(mrobot已完成，请连开发机进行测试)
/app/tagArticles.jsp 开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
mrobot地址：  http://mrobot.pclady.com.cn/s-900/yimei/cms/

说明

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

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
tag标签string 是
pageNo页数int1是
pageSize页面大小int20是

返回 

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

返回参数说明

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


1.5焦点页点赞、踩

开发环境： 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专题首页

(mrobot已完成，请连开发机进行测试)
/specialIndex.jsp 开发环境： http://dev15.pclady.com.cn/app/
线上环境： http://plastic.pclady.com.cn/app/
mrobot地址：  http://mrobot.pclady.com.cn/s-900/yimei/cms/

说明

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

缓存时间

15分钟

提交方式

GET

是否登录

否/是

数据来源

编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
common_session_id 太平洋通行证session string "" 是
pageNo 页码 int "" 是
pageSize 每页行数 int "" 是

返回 

{
  "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 我的订阅中新文章数量