[[TOC]] == 1.基本约定 == mrobot开发机代理:192.168.10.199 端口为 1080 [[BR]]mrobot测试机代理:192.168.10.198 端口为 1080 == 2.接口列表 == === 2.1 [=#point2.1 资讯-文章页终端] === {{{ (接口已上线) 请求url:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=4.5.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 HTTP请求方式:GET 是否需要登录:true 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 请求参数: common_session_id:登录后的session,Cookies传值 articleTemplate:版本号,当值为4.5.0时才能显示文章标签与最热评论 说明:点击整块热门评论部分,都是触发评论跳转 返回结果: 增加文章标签协议:pcautobrowser://article-tag/id 增加评论跳转协议: pcautobrowser://comment/topicId 热门评论直接从mrobot出,不需要再调用addComments(jsonArray), 当有数据时以jsonArray中前两条(有可能是一条)评论显示为热门评论部分 当数据为空时,不显示热门评论部分 }}} === 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" },... } }}}