Context Navigation

← Previous Change
Wiki History
Next Change →

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

Timestamp:: 02/17/2016 03:25:18 PM (10 years ago)
Author:: liguokai
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

pcauto_4.9.0/interface

                       v1
+[[TOC]]
+= 资讯4.9.0接口文档 (已完成接口开发机可测)=
+>mrobot代理环境说明：
+.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]]
+.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]]
+     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]]
+     制作地址：[[http://zzb.pcauto.com.cn/tools/gongdan/plan.php?id=173|猛戳前往]] [[BR]]
+     应用后端接口trac：[[http://trac.pc.com.cn/iphone/wiki/pcauto_4.8.2/interface|暂无]]
+== 1.资讯首页接口 ==
+'''(敬请期待)'''[[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]]
+> '''对于客户端逻辑，此版本需要注意：1.增加新版视频类型返回：type=9；2.版本号要改为v=4.8.2'''[[BR]]
+**缓存时间**
+>首页列表5分钟，其余栏目30分钟
+**提交方式**
+> GET
+**是否登录**
+> 否
+**数据来源**
+> cms、快搜、cmt、直播后台等等
+**参数**
+此版本对传入参数只做一个修改'''v=4.8.2'''。[[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中type=9表示新版视频[[BR]]
+||= 参数名 =||= 参数含义 =||
+||= type =||= 1文章，2帖子，3图集，4直播，5专题，6活动，7新专题，9视频，0其他 =||
+||= to-uri =||= 论坛版块pcautobrowser://bbs-topics/，图库图片pcautobrowser://album-photo/，车系界面pcautobrowser://serial/，车型界面pcautobrowser://model/ =||
+||= pageNo =||= 当type等于1（文章）时，假如有返回pageNo，要跳转到文章相应的pageNo页 =||
+||= articleType =||= 值为y表示旧文章 =||
+== 2.弹幕数据接口 ==
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getCmtByUrl.xsp?url=http://www.pcauto.com.cn/nation/774/7748168.html&articleId=7748168&reverse=0&pageNo=1&pageSize=20 [[BR]]
+>后端接口：http://cmt.pcauto.com.cn/intf/url2tid.jsp?urls=http://www.pcauto.com.cn/nation/774/7748168.html [[BR]]
+http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13317121&arch=0&reverse=0&pageSize=20 [[BR]]
+**说明**
+> '''此接口只出首页弹幕数据，评论终端页请使用以前文章页的评论接口'''[[BR]]
+**缓存时间**
+>无
+**提交方式**
+> GET
+**是否登录**
+> 否
+**数据来源**
+**参数**
+||=参数名=||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
+||=url=||= 该弹幕所属gif链接 =||= String =||= =||= 是 =||=  =||
+||=reverse=||= 评论排序 =||int||= 0 =||= 否 =||= 值为0倒序，1顺序 =||
+||=pageNo=||=页码=||= int =||= 1 =||= 否 =||= =||
+||=pageSize=||=每页条数=||= int =||= 20 =||= 否 =||=  =||
+**返回**
+{{{#!java
+{
+    "comments": [
+        {
+            "id": "29681519",
+            "userId": "32059577",
+            "name": "二两矿泉水",
+            "floor": "122",
+            "faceUrl": "http://i6.3conline.com/images/upload/upc/face/29/68/15/19/29681519_100x100",
+            "content": "慢慢来吧，这个价格真的事不好玩啊"
+        },
+        {
+            "id": "29681424",
+            "userId": "28393932",
+            "name": "么西么西0518",
+            "floor": "121",
+            "faceUrl": "http://i6.3conline.com/images/upload/upc/face/29/68/14/24/29681424_100x100",
+            "content": "原来哈弗H9的动力这么强悍！难怪售价这么高。"
+        }
+    ],
+    "pageNo": 1,
+    "pageCount": 61,
+    "total": 122
+}
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||
+||= id =||= 评论id =||
+||= userId =||= 用户id =||
+||= name =||= 用户名称 =||
+||= floor =||= 楼层数 =||
+||= faceUrl =||= 头像 =||
+||= content =||= 评论内容 =||
+== 3.GIF终端页JSON ==
+'''(开发已完成，调试请连开发机代理)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/gif_photo.xsp?url=http://dev2.pconline.com.cn:9191/upcfiles/autophotolib_bbs/1602/03/c0/40246_1454467582759.gif [[BR]]
+后端接口：
+[[BR]] http://cmt.pcauto.com.cn/intf/url2tid.jsp?urls=http://dev2.pconline.com.cn:9191/upcfiles/autophotolib_bbs/1602/03/c0/40246_1454467582759.gif
+[[BR]] http://cmt.pcauto.com.cn/intf/countcmt.jsp?tids=
+[[BR]] http://dev31.pcauto.com.cn:8012/template/pcauto_bbs/intf/gif_photo.jsp?url=http://dev2.pconline.com.cn:9191/upcfiles/autophotolib_bbs/1602/03/c0/40246_1454467582759.gif
+**说明**
+> GIF终端页JSON[[BR]]
+**缓存时间**
+>无
+**提交方式**
+> GET
+**是否登录**
+> 否
+**数据来源**
+>
+**请求参数**
+ ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
+ ||=url=||=String=||=是=||=gif链接=||
+**返回**
+{{{
+{
+    "desc": "",
+    "height": 172,
+    "name": "100862",
+    "retCode": 1,
+    "url": "http://dev2.pconline.com.cn:9191/upcfiles/autophotolib_bbs/1602/03/c0/40246_1454467582759.gif",
+    "width": 170,
+    "count": 0
+}
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||
+||= desc =||= 图集描述 =||
+||= height =||= 图片高度 =||
+||= name =||= 图集标题 =||
+||= retCode =||= 获取数据状态，值为1表示成功，0失败 =||
+||= url =||= gif链接 =||
+||= width =||= 图片宽度 =||
+||= count =||= 评论数 =||