Changes between Version 2 and Version 3 of pcauto_4.4.0/interface

Timestamp:

07/10/2014 11:22:35 AM (12 years ago)

Author:

hejingdong

Comment:

--

pcauto_4.4.0/interface

@@ -116 +116 @@
 
 }}}
+
+=== 2.2 [=#point202 文章终端]===
+{{{
+ 备注：获取文章
+ 请求URL：http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=3.6.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：html页面
+ 缓存方式：无
+ 缓存时间：1小时
+ 请求参数：
+        文章ID
+        articleTemplate=3.6.0
+        size：字体大小
+        app=pcautobrowser
+        picRule：请求网络方式：0 非wifi； 2  wifi访问
+        pageNo：页码
+        template：模板
+        channelId：栏目ID
+        serialId：车系ID
+        date：文章直播时间（说明：当参数template＝live时，传递date，否则不传）
+        阅读模式：无参数 白天；night 晚间
+ 请求后端URL：
+        helper_uri_articles_3?id=4147040
+ 请求后端参数：
+        id：4147040（从id_0取出）
+
+4.4版本增加协议：
+添加订阅:
+pcaction://addSubscribe/id?serialName=xxx&price=xxx&image=xxx
+pcautobrowser://serial/id
+
+}}}
+
+=== 2.3 [=#point203 获取评论接口]===
+{{{
+备注：获取文章评论
+ 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        topicId：主题ID
+        articleId：文章ID
+        reverse：排序方式：0  倒序； 1 正序
+        pageNo：页码
+        pageSize：每页行数
+        pic:是否图片评论：0或者不填否，1是
+ 请求后端URL：
+        http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13118127&arch=0&reverse=0&pageSize=20
+        http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13118127
+ 请求后端参数：
+        tid：主题ID（从id_0取出）
+        reverse：排序方式：0  倒序； 1 正序
+        pageSize：每页行数
+返回参数：
+{
+  "comments": [
+    {
+      "1": {
+        "client": "1",
+        "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684",
+        "floor": "113",
+        "id": "27265992",
+        "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB",
+        "time": "2014-07-08 09:50:03",
+        "userId": "0"
+      },
+      "current": "1",
+      "expand": false,
+      "support": "0"
+    },
+    {
+      "1": {
+        "client": "1",
+        "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684",
+        "floor": "112",
+        "id": "27265870",
+        "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB",
+        "time": "2014-07-08 09:37:55",
+        "userId": "0"
+      },
+      "current": "1",
+      "expand": false,
+      "support": "0"
+    }
+  ],
+  "pageCount": 6,
+  "pageNo": 1
+}
+}}}
+
+=== 2.3.1 [=#point2031 回复文章评论]===
+{{{
+备注：回复文章评论
+ 请求URL：http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
+ HTTP请求方式：post
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        topicId：主题ID
+        topicUrl：主题url
+        articleTitle：文章标题
+        content：回复内容
+        name：用户名
+        是否匿名：0 否
+        replyFloor：回复楼层
+        articleId：文章ID
+}}}
+
+=== 2.4 [=#point204 热门对比]===
+{{{
+备注：热门对比
+ 请求URL：
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：HTML页面
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        sid：车系id
+        night:有此参数为夜间模式，否则为日间模式
+点击对比按钮，跳转协议
+pcaction://hot-pk/?id1=xx&id2=xx&name1=xxx&name2=xxx
+}}}
+
+=== 2.5 [=#point205 精准选车条件]===
+{{{
+备注：精准选车条件
+ 请求URL：
+         v4.3之前使用此接口：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0
+         v4.3之后使用此接口：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.3.0
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：7天
+ 请求参数:
+        v：版本号，v有两个可选值，分别为4.0.0、4.3.0
+ 请求后端URL：
+        http://ks.pcauto.com.cn/search.jsp?q=state:1&returnType=json&appName=auto_price&perPage=0
+        &clustered=cluster_price,cluster_brand,cluster_std_displacement,cluster_kind,cluster_gearbox
+
+4.4版本修改：
+返回结果增加，显示更多的条件
+}}}
+
+=== 2.6 [=#point206 视频分类]===
+{{{
+备注：视频分类
+ 请求URL：
+
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数:
+返回参数：
+{
+  types:[
+     {
+        id:1,
+        name:原创视频
+     },
+     {
+        id:2,
+        name:新车视频
+     },
+     {
+        id:3,
+        name:娱乐百态
+     }
+  ]
+}
+}}}
+
+=== 2.6.1 [=#point2061 价格范围]===
+{{{
+备注：价格范围
+ 请求URL：
+
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数:
+返回参数：
+{
+  prices:[
+     {
+        id:1,
+        name:10万<=
+     },
+     {
+        id:2,
+        name:10-15万
+     },
+     {
+        id:3,
+        name:15-20万
+     }
+  ]
+}
+}}}
+
+=== 2.6.2 [=#point2062 用车宝典]===
+{{{
+备注：用车宝典
+ 请求URL：
+
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数:
+返回参数：
+{
+  sections:[
+     {
+        id:1,
+        name:驾驶技巧
+        sections:[
+           {
+              id:4
+              name:恶劣天气驾驶技巧
+              sections:[
+                 {
+                   id:4
+                   name:下雪怎么开车
+                }
+           }
+        ]
+     }
+  ]
+}
+}}}
+
+=== 2.6.3 [=#point2063 新车上市]===
+{{{
+备注：新车上市
+ 请求URL：
+
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数:
+返回参数：
+{
+  "coming":
+  {
+    id
+    name
+  }
+  "recently":
+  {
+        id
+    name
+  }
+}
+}}}
+
+=== 2.7 [=#point207 资讯栏目]===
+{{{
+备注：资讯栏目
+ 请求URL：http://mrobot.pcauto.com.cn/v2/cms/channels/1
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：5分钟
+ 请求参数：
+        栏目ID
+        省份pro和城市city // 当栏目id为55555时该参数有效
+
+4.4版本修改：
+新增“游记”栏目（ID 000048723） 和 “赛事”栏目（000058522），位置放在“用车”后面
+}}}
+
+=== 2.7.1 [=#point207 视频栏目列表]===
+{{{
+备注：视频栏目列表
+ 请求URL：
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数：
+返回结果：
+{
+  "articleList": [
+    {
+      "id": "4254001",
+      "pubDate": "2014-04-18",
+      "title": "What is My Car? 最适合的才最好",
+      "url": "http://www.pcauto.com.cn/news/425/4254001.html"
+    },
+    {
+      "id": "3683314",
+      "pubDate": "2013-12-31",
+      "title": "戴姆勒Car2Share驾临鹏城 腾讯乐享创新出行",
+      "url": "http://www.pcauto.com.cn/news/368/3683314.html"
+    }
+  ],
+  "curPage": 1,
+  "perPage": 100,
+  "start": 1,
+  "statistic": {
+    "cluster_channel": [
+      "新闻动态_41"
+    ]
+  },
+  "time": 0,
+  "total": 41
+}
+
+}}}
+
+=== 2.7.2 [=#point207 导购栏目列表]===
+{{{
+备注：导购栏目列表
+ 请求URL：
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数：
+返回结果：
+{
+  "articleList": [
+    {
+      "id": "4254001",
+      "pubDate": "2014-04-18",
+      "title": "What is My Car? 最适合的才最好",
+      "url": "http://www.pcauto.com.cn/news/425/4254001.html"
+    },
+    {
+      "id": "3683314",
+      "pubDate": "2013-12-31",
+      "title": "戴姆勒Car2Share驾临鹏城 腾讯乐享创新出行",
+      "url": "http://www.pcauto.com.cn/news/368/3683314.html"
+    }
+  ],
+  "curPage": 1,
+  "perPage": 100,
+  "start": 1,
+  "statistic": {
+    "cluster_channel": [
+      "新闻动态_41"
+    ]
+  },
+  "time": 0,
+  "total": 41
+}
+}}}
+
+=== 2.7.3 [=#point207 用车栏目列表]===
+{{{
+备注：用车栏目列表
+ 请求URL：
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数：
+返回结果：
+{
+  "articleList": [
+    {
+      "id": "4254001",
+      "pubDate": "2014-04-18",
+      "title": "What is My Car? 最适合的才最好",
+      "url": "http://www.pcauto.com.cn/news/425/4254001.html"
+    },
+    {
+      "id": "3683314",
+      "pubDate": "2013-12-31",
+      "title": "戴姆勒Car2Share驾临鹏城 腾讯乐享创新出行",
+      "url": "http://www.pcauto.com.cn/news/368/3683314.html"
+    }
+  ],
+  "curPage": 1,
+  "perPage": 100,
+  "start": 1,
+  "statistic": {
+    "cluster_channel": [
+      "新闻动态_41"
+    ]
+  },
+  "time": 0,
+  "total": 41
+}
+}}}
+
+=== 2.7.1 [=#point207 新车栏目列表]===
+{{{
+备注：新车栏目列表
+ 请求URL：
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：
+ 请求参数：
+返回结果：
+{
+  "modelId": 424,//该车系第一个车型
+  "modelName": “宝马3系”,//该车系第一个车型
+  "serialId": 354,
+  "serialName": "马自达6",
+  "price": "28.3-66.2万",
+  "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/05/c0/28324073_1383616337906_270x202.jpg",
+  "type":1新车，2改款
+}
+}}}
+
+=== 2.8 [=#point208 判断文章是否已经收藏]===
+{{{
+ 备注：判断文章是否已经收藏
+ 请求URL：
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        common_session_id：用户登陆后获得的认证id
+        aid:文章id
+ 返回参数：如果已经登陆并且已经收藏，返回收藏id，否则返回-1
+}}}
+
+
+=== 2.8.1 [=#point2081 判断车系是否已经收藏]===
+{{{
+ 备注：判断车系是否已经收藏
+ 请求URL：
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        common_session_id：用户登陆后获得的认证id
+        sid:车系id
+ 返回参数：如果已经登陆并且已经收藏，返回收藏id，否则返回-1
+}}}
+
+
+=== 2.8.1 [=#point2081 判断车系是否已经收藏]===
+{{{
+ 备注：判断车系是否已经收藏
+ 请求URL：
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        common_session_id：用户登陆后获得的认证id
+        sid:车系id
+ 返回参数：如果已经登陆并且已经收藏，返回收藏id，否则返回-1
+}}}
+
+
+=== 2.8.2 [=#point2082 判断车型是否已经收藏]===
+{{{
+ 备注：判断车型是否已经收藏
+ 请求URL：
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        common_session_id：用户登陆后获得的认证id
+        mid:车型id
+ 返回参数：如果已经登陆并且已经收藏，返回收藏id，否则返回-1
+}}}