Context Navigation

← Previous Change
Wiki History
Next Change →

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

Timestamp:: 05/06/2015 03:13:53 PM (11 years ago)
Author:: liguokai
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

pcauto_4.7.1/interface

                       v1
+[[TOC]]
+== 1.基本约定 ==
+mrobot开发机代理：192.168.10.199 端口为 1080
+[[BR]]mrobot测试机代理：192.168.10.198 端口为 1080
+== 2.接口列表 ==
+=== 2.1 [=#point2.1 找车-按条件找车] ===
+[[BR]](接口已上线）
+[[BR]]新接口:http://mrobot.pcauto.com.cn/v3/price/chooseOptionLink?index=1
+[[BR]]原接口:http://mrobot.pcauto.com.cn/buy/price/chooseOption
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:接口缓存
+[[BR]]缓存时间:1小时
+[[BR]]说明:原接口是报价的接口，会与报价冲突
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||index||Strng||可选||index=1标识初始化||
+[[BR]]返回数据结构
+[[BR]]数据结构和旧报价接口一致
+=== 2.2 [=#point2.2 直播改版] ===
+==== 2.2.1 [=#point2.2.1 首页栏目] ====
+(接口已上线）
+[[BR]]新接口:http://mrobot.pcauto.com.cn/configs/pcauto_v4_cms_iphone_channel_tree（IOS）
+[[BR]]新接口：http://mrobot.pcauto.com.cn/configs/pcauto_v4_cms_android_channel_tree（Android）
+[[BR]]原接口:http://mrobot.pcauto.com.cn/configs/pcauto_v3_cms_iphone_channel_tree（IOS）
+[[BR]]原接口：http://mrobot.pcauto.com.cn/configs/pcauto_v3_cms_android_channel_tree（Android）
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]说明:V4.7.0需要新增“直播”栏目，同时旧版本屏蔽该栏目
+[[BR]]返回数据结构
+{{{
+{
+news: [
+[
+"1",
+"首页",
+"696"
+],
+[
+"2",
+"新车",
+"296"
+],
+[
+"55555",
+"行情",
+"297"
+],
+[
+"3",
+"导购",
+"298"
+],
+...
+[
+"18",
+"直播",
+"723"
+]
+],...
+}}}
+==== 2.2.2 [=#point2.2.2 直播栏目列表] ====
+(接口已上线）
+[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v2/cms/channels/18?v=4.0.0&pageNo=1&pageSize=2
+[[BR]]后台接口:http://www.pcauto.com.cn/app/000082762/000082782/1503/intf6607.js#
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]说明:需分页；一个直播内容包含banner图、标题、直播状态、时间、评论数/回复数共5个要素
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||v||String||可选||版本号，v=4.0.0表示4.0以后的版本||
+||pageNo||int||必须||页码(默认为1)||
+||pageSize||int||必须||每页大小（默认为200）||
+[[BR]]返回数据结构
+{{{
+{
+ data: [
+ {
+  banner(图片): "http://img0.pcauto.com.cn/pcauto/app/000082762/000082782/1503/00002.png",
+  count（评论数）: 0,
+  titile（标题）: "【跑男来助阵】 售价14.59-21.39万 凌渡上市直播回顾",
+  zbId: "6433050",
+  zbState（直播状态：1表示正在直播，0表示已结束）: "1",
+  zbTime: "2015-02-03 15:02:00",
+  zbType（type=1表示直播文章，0表示论坛帖子）: "0",
+  zbUrl: "http://bbs.pcauto.com.cn/topic-6433050.html"
+  },
+ {
+  banner: "http://img0.pcauto.com.cn/pcauto/app/000082762/000082782/1503/0011.jpg",
+  count: 386,
+  titile: "2015日内瓦车展现场直播",
+  zbId: "151",
+  zbState: "1",
+  zbTime: "2015-06-02 13:05:00",
+  zbType: "1",
+  zbUrl: "http://live.pcauto.com.cn/broadRecord.jsp?broadcastId=151"
+ }
+ ],
+ pageNo: 1,
+ pageSize: 2,
+ total: 2
+}
+}}}
+==== 2.2.3 [=#point2.2.3 直播内容详情页] ====
+(接口已上线）
+[[BR]]mrobot接口:mrobot接口:http://mrobot.pcauto.com.cn/v3/zbDetail?broadcastId=191&size=18
+[[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/_ajaxRecord.jsp?broadcastId=191&pageNo=1&pageSize=20
+[[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/getBroadcast.jsp?broadcastId=191
+[[BR]]协议（评论节点内容）:pcaction://writeComment/partId?zbUrl=&recordId=
+[[BR]]协议（回复评论）: pcaction://replyComment/partId?zbUrl=&&floor=&recordId=
+[[BR]]协议（点击更多）：pcaction://loadMoreComment/partId?zbUrl=&pageNo=1&pageSize=20&recordId=
+[[BR]]协议（个人中心）：pcaction://user-center/userId
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:html
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]说明:页面源码中_HTML_META_START_需提供以下数据：
+[[BR]]title——直播标题
+[[BR]]status——0表示已结束,1表示正在直播，2表示其他
+[[BR]]anchorImg——主播头像
+[[BR]]anchor——主播名称
+[[BR]]abstract——直播简介（这个需要保留a标签）
+[[BR]]contentNum——该页的内容数量
+[[BR]]url——PC端地址
+[[BR]]firstPic——用于分享的图片地址
+[[BR]]thumbPic——用于分享的图片地址
+[[BR]]
+[[BR]]刷新评论区函数：function commentShow(reqUrl,reqPartId,reqRecordId){}
+[[BR]]reqUrl：直播地址
+[[BR]]reqPartId:直播节点评论id
+[[BR]]reqRecordId:直播节点内容id
+[[BR]]
+[[BR]]manGetRecord()  获取最新直播内容函数
+[[BR]]
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||broadcastId||String||必须||直播id||
+||order||String||可选||按时间排序，1升序，0降序，默认为0 ||
+||size||String||可选||设置字体大小（16小/18中/20大）||
+ps：（size参数限制字号选择范围在16--21）
+==== 2.2.4 [=#point2.2.4 直播节点查看更多页] ====
+(接口已上线）
+[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v3/zbCommentDetail?recordId=1511&broadcastId=151&pageNo=1&pageSize=20&partId=1425267845000
+[[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/getRecordByID.jsp?recordId=1511
+[[BR]]后台接口:http://cmt.pcauto.com.cn/templates/pcauto/getPartList.jsp?url=http://live.pcauto.com.cn/broadRecord.jsp?broadcastId=151&pageNo=1&pageSize=20&partId=1425267845000
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:html
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]说明:
+[[BR]]
+[[BR]]刷新评论区函数：function commentShow(reqUrl,reqPartId,reqRecordId){}
+[[BR]]reqUrl：直播地址
+[[BR]]reqPartId:直播节点评论id
+[[BR]]reqRecordId:直播节点内容id
+[[BR]]
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||recordId||String||必须||直播节点id||
+||broadcastId||String||必须||直播id||
+||pageNo||String||可选||页码||
+||pageSize||String||可选||页面大小||
+||partId||String||必须||节点评论id||
+==== 2.2.5 [=#point2.2.5 直播文章分节点评论] ====
+(接口已上线）
+[[BR]]cmt接口：http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp （由于mrobot线上接口会出现获取不了用户外网ip问题，请客户端使用cmt接口，参数不变）
+[[BR]]HTTP请求方式:post
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]说明:当存在[[BR]]
+请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||id/url||String||必须|| 二选一，必填
+||content||String||必须||评论内容||
+||title||String||选填||主题||
+||replyFloor2||String||选填||回复楼层（若有）||
+||windowname||String||选填||选填，默认为0||
+||anonymous||String||选填||选填，1为匿名||
+||partId||String||选填||选填，分段落评论的段落id||
+||client||String||选填||选填（最好按实际情况给参）||
+[[BR]]返回数据结构
+{{{
+{
+        "brief": "A57EWEW",
+        "commentCount": 1,
+        "commentId": 28545421,
+        "createTime": "2015-03-20 10:43:07",
+        "floor": 9,
+        "ip": "59.42.240.7",
+        "resultCode": 0,
+        "resultMsg": "您的评论已经成功发表。注：评论在审核后才能出现在列表中,谢谢！",
+        "showName": "广东省广州市网友",
+        "status": 0,
+        "topicId": 13272513,
+        "userId": -1
+}
+}}}
+=== 2.3 [=#point2.3 违章查询] ===
+==== 2.3.1 [=#point2.3.1 平安的违章查询页面] ====
+新页面url:
+[[BR]]原url:http://cha.wcar.net.cn/taipingyang
+==== 2.3.2 [=#point2.3.2 发送用户的查询信息到调查系统] ====
+接口:http://survey.pcauto.com.cn/auto/submit.jsp
+[[BR]]HTTP请求方式:post
+[[BR]]是否需要登录:false
+[[BR]]返回格式:无
+[[BR]]缓存方式和时间:无
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||req_enc||string||必须||编码（固定值）：utf-8||
+||q_45329||string||必须||查询地区||
+||q_45330||string||必须||车牌号||
+||q_45331||string||必须||发动机号||
+||q_45332||string||必须||车架号||
+||q_45333||string||必须||手机号码||
+||q_45334||string||必须||购车日期||
+||id||string||必须||固定值：12884||
+||ver||string||必须||固定值：-1||
+||questions||string||必须||固定值：空||
+[[BR]]说明：当用户进行违章查询，获取页面这些用户信息发送到调查系统；用户再次查询如查询信息不变则不需要再调用，如有变化需要再次调用此接口发送新的信息；不需要处理请求结果
+=== 2.4 [=#point2.4 关于车系/车型图片] ===
+==== 2.4.1 [=#point2.4.1 车系车型全部type分类图片信息] ====
+(接口已上线）
+[[BR]]mrobot旧接口:http://mrobot.pcauto.com.cn/v2/price/nav_pictures?serialGroupId=4457&modelId=0
+[[BR]]mrobot新接口:http://mrobot.pcauto.com.cn/v2/price/nav_picturesv47?serialGroupId=4457&modelId=0
+[[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/photo_category_list.jsp
+[[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?mIds=
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||serialGroupId||String||必须||车系id||
+||modelId||String||必须||车型id||
+[[BR]]返回数据结构
+{{{
+{
+sections: [
+{
+photos: [
+{
+bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416688748_400x300.jpg",
+modelId: "36737",
+modelName: "凌渡 2015款 280TSI DSG豪华版 ",
+price: "19.99",
+sellState: 0,  (0:在售，1：即将上市，2：其它)
+smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416688748_120x90.jpg"
+},
+{
+bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416692674_400x300.jpg",
+modelId: "36737",
+modelName: "凌渡 2015款 280TSI DSG豪华版 ",
+price: "19.99",
+sellState: 0,
+smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416692674_120x90.jpg"
+},
+...
+}
+}}}
+==== 2.4.2 [=#point2.4.2 车系车型图片] ====
+(接口已上线）
+[[BR]]mrobot旧接口:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=4457&pageSize=99999&v=4.7.0&modelId=0&typeId=1&colorId=0
+[[BR]]mrobot新接口:http://mrobot.pcauto.com.cn/v2/price/picturesv47?serialGroupId=4457&pageSize=99999&v=4.7.0&modelId=0&typeId=1&colorId=0
+[[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp
+[[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?mIds=
+[[BR]]HTTP请求方式:get
+[[BR]]是否需要登录:false
+[[BR]]返回格式:json
+[[BR]]缓存方式:
+[[BR]]缓存时间:
+[[BR]]请求参数:[[BR]]
+||参数名||类型||必须||说明||
+||serialGroupId||String||必须||车系id||
+||modelId||String||必须||车型id||
+||pageNo||int||可选||页码||
+||pageSize||int||可选||页面大小||
+||v||int||必须||v=4.7.0出4.7版本后的数据||
+||typeId||int||可选||分类||
+||colorId||int||可选||颜色||
+[[BR]]返回数据结构
+{{{
+{
+pageCount: "1",
+pageNo: 1,
+pageSize: 99999,
+sections: [
+{
+photos: [
+{
+bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_400x300.jpg",
+modelId: "36339",
+modelName: "奥迪Q5 2015款 40 TFSI 技术型 ",
+price: "43.16",
+sellState: 0,
+smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_120x90.jpg"
+},...
+}
+}}}