Changes between Initial Version and Version 1 of pcauto_4.8.0/interface

Timestamp:

10/09/2015 02:30:15 PM (11 years ago)

Author:

zengqingyi

Comment:

先建立此页，内容待修改

pcauto_4.8.0/interface

@@ +1 @@
+[[TOC]]
+
+= 汽车资讯4.8.0接口文档 （先建立此页，内容待修改）=
+>mrobot代理环境说明： 
+     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]] 
+     192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] 
+     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]] 
+     制作地址： [[BR]] 
+     应用后端接口trac：
+== 1.互动 ==
+----------
+
+
+=== 1.1评论接口 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.7/newTopics.xsp?topicId=13285745 [[BR]]
+cmt开发环境：暂无 [[BR]]
+cmt线上环境：http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13285745&arch=0&reverse=0 [[BR]]
+             http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13285745 [[BR]]
+
+**说明**
+
+> 获取某个话题评论列表[[BR]]
+
+**缓存时间**
+
+>无
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+> cmt
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
+||= pageNo =||= 页数 =||int||= 1 =||= 否 =||=  =||
+||= pageSize=||= 每页条数 =||int||= 20 =||= 否 =||=  =||
+||= topicId =||=挂评论的话题id =||= string =||=  =||= 是 =||= 应用端需要 =||
+||= articleId=||=文章id=||= string =||=  =||= 否 =||=  =||
+||= reverse=||=是否倒序 =||= string =||=  =||= 否 =||=  =||
+**返回**
+
+
+
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||
+||= =||=  =||
+
+== 2.资讯 ==
+----------
+
+
+=== 2.1栏目接口 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0 [[BR]]
+例如：http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0 [[BR]]
+cmt开发环境：http://test2.pcauto.com.cn:8002/app/json/ [[BR]]
+cmt线上环境：http://www.pcauto.com.cn/app/21json [[BR]]
+
+**说明**
+
+> 此接口为资讯客户端15个栏目集合，涉及参数以及各种情景太多，实在不能穷举，以下只列出新增内容。[[BR]]
+> '''对于客户端逻辑，此版本只需要新增一个pageNo的返回值处理，当接口返回JSONObject为文章类型，并且返回pageNo时，打开文章页且跳到对应的pageNo页'''[[BR]]
+
+**缓存时间**
+
+>首页列表5分钟，其余栏目30分钟
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+> cms、快搜、cmt、直播后台等等
+
+**参数**
+
+请参照客户端旧逻辑，此版本对传入参数无修改。[[BR]] 
+**返回**
+{{{#!java
+{
+    "data": [
+        {
+            "articleType": "y",
+            "channelId": 1,
+            "channelName": "头条",
+            "count": 0,
+            "downs": 0,
+            "id": "6929470",
+            "image": "http://img0.pcauto.com.cn/pcauto/1509/14/g_6959543_1442223329657_240x160.jpg",
+            "pageNo": 3,
+            "pubDate": "2013-01-01",
+            "title": "测试旧文章",
+            "type": 1,
+            "ups": 0,
+            "url": "http://www.pcauto.com.cn/teach/692/6929470_2.html"
+        }
+    ],
+    "focus": [ 
+        {
+            "articleType": "n",
+            "id": "1623455",
+            "image": "http://img0.pcauto.com.cn/pcauto/app/daogou/1108/201108311.jpg",
+            "pubDate": "2011-08-31",
+            "title": "哈弗H6挑战比亚迪S6/瑞虎/海马骑士",
+            "topicUrl": "http://www.pcauto.com.cn/teach/1108/1622411.html",
+            "url": "http://www.pcauto.com.cn/app/daogou/1108/1623455.html"
+        }
+    ],
+    "pageNo": 1,
+    "pageSize": 1,
+    "topData": [
+        {
+            "cc-uri": "http://count.imofan.com/count?url=http://www.pcauto.com.cn/nation/669/6690671.html&ad=132",
+            "channelId": 0,
+            "channelName": "",
+            "count": 0,
+            "downs": 0,
+            "id": "161",
+            "image": "http://img0.pcauto.com.cn/pcauto/1503/15/6055040_567.jpg",
+            "isExtend": "0",
+            "preView": "央视3·15晚会正在直播 消费在阳光下",
+            "pubDate": "2015-03-15",
+            "seq": 1,
+            "title": "央视3·15晚会直播回顾 消费在阳光下",
+            "to-uri": "pcautobrowser://information-article/161?template=live",
+            "type": 4,
+            "updateAt": 1436284800000,
+            "ups": 0
+        }
+    ],
+    "topFocus": [
+        {
+            "image": "http://www1.pcauto.com.cn/test/qwegf3wrefgvazv.jpg",
+            "seq": 1,
+            "title": "驾名爵锐腾1.5T四驱豪华版",
+            "to-uri": "http://m.pcauto.com.cn/x/guangzhou/?type=zt&FromApp=1&browser=commonwebview&v=4.5.0",
+            "updateAt": 1437408000000
+        }
+    ],
+    "total": 150
+}
+}}}
+
+
+**返回参数说明**
+[[BR]] 在data与focus数组内的每一个JSONOject增加以下参数返回[[BR]]
+注意：'''pageNo是此版本客户端要新增的处理，客户端同事特别注意。'''[[BR]]
+||= 参数名 =||= 参数含义 =||
+||= type =||= 1文章，2帖子，3图集，4直播，5专题，6活动，0其他 =||
+||= to-uri =||= 论坛版块pcautobrowser://bbs-topics/，图库图片pcautobrowser://album-photo/，车系界面pcautobrowser://serial/，车型界面pcautobrowser://model/ =||
+||= pageNo =||= 当type等于1（文章）时，假如有返回pageNo，要跳转到文章相应的pageNo页 =||
+||= articleType =||= 值为y表示旧文章 =||