wiki:pclady_news2.0.0_api

Version 43 (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资讯首页

开发环境: 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"" 为空时返回服务器当天数据,随后使用后端返回的数据来请求,格式YYYY-MM-DD

返回

{
  "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":"作者昵称",
        "authorImageUrl":"作者头像",
        "articleID":"文章id"
        "imageUrl":"文章图片",
        "title":"文章标题",
        "desc":"文章正文前xxx字"
      }
    ]
  }
}

返回参数说明

参数名 参数含义 参数名参数含意
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来完成,评论数据从评论系统获取,参考  1.3文章评论列表

缓存时间

15分钟

提交方式

GET

是否登录

数据来源

编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
articleID 文章ID string ""
common_session_id 太平洋通行证session string ""
fmt fmt=json 时显示接口数据String""
appVersion= 版本号string""
inReview= 1:审核状态 0:发布状态int 0 ios审核时用到

返回

{
  "status":0,
  "msg":"请求成功",
  "articleID":"文章ID",
  "authorID":"作者ID",
  "authorName":"作者昵称",
  "authorWXID":"作者微信订阅号",
  "headImageUrl":"文章头图",
  "title":"文章标题",
  "collectCount":100,
  "supportCount":100,
  "opposeCount":50,
  "sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss",
  "html":"文章html文本",
  "css":"样式文本",//看后端怎么保存文章的,html和css、js等放一起也可以
  "relativeSpecialList":[
    {//相关专题
      "specialID":"专题ID",
      "specialName":"专题名称",
      "introduceText":"专题简介文本",
      "imageUrl":"专题图片",
      "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
articleId 文章ID string ""
reverse 排序方式 string "" 0 倒序; 1 正序

返回

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


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

是否登录

数据来源

编辑后台

参数

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

返回

{
  "status":0,
  "msg":"请求成功",
  "pageNo": 1, 
  "pageSize": 20,
  "total": 100,
  "data":{
    "articleList":[
      { 
        "authorID":"作者ID",
        "authorName":"作者名称",
        "articleID":"文章ID",
        "title":"文章标题",
        "articleID":"文章ID",
        "imageUrl":"文章图片"
      }
    ]
  }
}

返回参数说明

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


1.5焦点页点赞、踩

/supportFocus.jsp 开发环境: 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 "" 如果登陆了就传
deviceID 设备ID string "" 根据设备号判定(是否需要与评论点赞的保持一致?)

返回

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

返回参数说明

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


1.6文章点赞、踩

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

说明

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

缓存时间

0分钟

提交方式

POST

是否登录

数据来源

编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
focusID 焦点图ID string ""
sp 操作类型 string "" 1:点赞,2:踩
common_session_id 太平洋通行证session string "" 如果登陆了就传
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 ""
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 ""

返回

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

返回

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

返回参数说明

参数名 参数含义 参数名参数含意
hasCollected 0:为收藏,1:已收藏

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


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

返回参数说明

参数名 参数含义 参数名参数含意
authorName 作者名称 authorID 作者ID
superSpecialName 文章所属专题的分类名称
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订阅专题页

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

说明

登陆后订阅专题页

缓存时间

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页数int1
pageSize页面大小int20

返回

{
  "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/vote.xsp

说明

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

缓存时间

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审核时用到

返回

{
  "status":0,
  "msg":"请求成功",
  "activityID":"活动ID",
  "activityType":"活动类型",
  "activityTitle":"活动标题",
  "activityDesc":"活动简介",
  "imageUrl":"活动图片",
  "userCount":"参与人数",
  "optionList":[//投票选项
    {
      "optionID":"选项ID",
      "optionTile":"选项标题",
      "optionImageUrl":"选项图片"
    },
    ......
  ]
}

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

返回参数说明

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


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

说明

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

缓存时间

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审核时用到

返回

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

返回

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

返回参数说明

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


3.5活动是否被用户收藏

开发环境: 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 ""

返回

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

返回参数说明

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


4.自媒体


4.1自媒体列表

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

说明

读取所有自媒体列表

缓存时间

15分钟

提交方式

GET

是否登录

数据来源

编辑后台

参数

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

返回

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

返回参数说明

参数名 参数含义 参数名参数含意
authorName 作者名称 authorID 作者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自媒体IDint
pageNo页数int1
pageSize页面大小int20

返回

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


5.个人中心


5.1修改昵称

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

说明

修改昵称

缓存时间

0分钟

提交方式

POST

是否登录

数据来源

编辑后台

参数

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

返回

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

返回参数说明

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


5.2修改头像

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

说明

修改头像

缓存时间

0分钟

提交方式

POST

是否登录

数据来源

编辑后台

参数

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

返回

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

返回

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

返回参数说明

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


6.协议约定