| Version 185 (modified by wuxiaoling, 11 years ago) (diff) |
|---|
Table of Contents
- 1.基本约定
- 2.接口列表
- 2.1.1 资讯首页
- 2.1.2 文章页终端
- 2.1.2.1 文章页标签跳转列表
- 2.1.3 地区选择
- 2.2.0 论坛首页-热门版块
- 2.2.0.1 论坛首页-猜你喜欢
- 2.2.1 帖子列表
- 2.2.2 帖子终端
- 2.2.3 删帖
- 2.2.4 加精
- 2.2.5 评分
- 2.2.5.1 用于获取用户实时分数
- 2.2.6 精华设置
- 2.3.0 搜索关键词提示
- 2.3.1 搜索结果-综合
- 2.3.1.1 搜索结果-帖子
- 2.3.1.2 搜索结果-文章
- 2.4.0 车型库首页
- 2.4.1 车系综述页
- 2.4.2 车系参配页
- 2.4.3 车系优惠(降价)列表
- 2.4.3.1 车系优惠详情页
- 2.4.4 车系点评页
- 2.4.5 车系车型图片筛选条件
- 2.4.6 车系\车型图片
- 2.4.6.1 车系\车型全部type分类图片信息
- 2.4.7 车系经销商
- 2.4.7.1 经销商(车系)详情
- 2.4.7.2 经销商(车系)详情的促销优惠列表
- 2.4.8 公司介绍
- 2.4.9 询底价页
- 2.4.10 精准选车条件结果
- 2.4.11 我要优惠
- 2.4.12 预约试驾
- 2.4.13 车系-文章
- 2.4.14 车型-综述
- 2.4.15 车型库-根据厂商id出该厂商的所有车系
- 2.5.0 离线下载包
- 2.5.1 修改昵称
- 2.5.2 违章查询
- 2.5.3 常见问题
- 2.5.3.1 常见问题终端
- 2.5.4 返回包括关注的好友和粉丝
- 2.5.5 我的收藏-经销商
- 2.5.5.1 经销商收藏
- 2.5.5.2 删除经销商收藏
- 2.5.5.3 文章收藏相关
- 2.6.0 降价列表
1.基本约定
接口通用参数 req_enc=utf-8(必须放url后面) resp_enc=utf-8(必须放url后面) common_session_id=xxxx(以cookies中的优先) 接口URL: 接口URL 必填参数:参数名=xxx(多种情况用括号解析) 非必填参数:参数名=xxx(多种情况用括号解析) 说明文档参数:添加某特定参数可以直接看接口文档 是否需要登录:是,否 返回格式:json,ssi,xml 缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存() 缓存时间:缓存时间 返回结果:结果可能情况
2.接口列表
2.1.1 资讯首页
请求url:http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:接口缓存
缓存时间:5分钟
请求参数:
channelId:栏目id
说明:
返回结果中type说明
0其他
1文章
2帖子
3图集
4直播
5专题
6活动
7新专题-上面一个专题名,下面是展示3篇文章
8新图集-展示图集名和三张小图--这个4.5不做
编辑填写说明:
1、进入到mrobot后台-》业务管理-》头条文章管理,点击右边选择“pcauto”
2、新专题模块的头部banner的链接,必须带有参数:v=4.5.0&type=zt,具体链接由编辑提供
3、banner下方的信息,和原来填写文章或者帖子的一样,另外要加上参数:belongToNewZt=X,这里的X为数字,对应的是banner所处位置的序号,
表示该信息所属的banner,信息自带的序号seq表示在列表中的相互位置,正序排列,这里只能填写文章或者帖子
返回结果:
说明:新专题,在topData的列表中,type为7,其中包含的文章和帖子列表,在articlesAndTopics字段
{
"data": [
{
"channelId": 10,
"channelName": "行业",
"count": 0,
"downs": 26,
"id": "5335928",
"image": "http://img0.pcauto.com.cn/pcauto/1410/23/g_5335928_1414030154561_240x160.jpg",
"pubDate": "2014-10-23",
"title": "速腾召回措施犯众怒 车主将提起诉讼",
"type": 1,
"ups": 117,
"url": "http://www.pcauto.com.cn/news/533/5335928.html"
}
],
"focus": [
{
"id": "5332119",
"image": "http://img0.pcauto.com.cn/pcauto/nation/ycxc/1410/5332119.jpg",
"pubDate": "2014-10-23",
"title": "新一代福特锐界前景分析 国产得以正名",
"topicUrl": "http://www.pcauto.com.cn/nation/533/5332119.html",
"url": "http://www.pcauto.com.cn/nation/533/5332119.html"
}
],
"pageNo": 1,
"pageSize": 20,
"topData": [
{
"articlesAndTopics": [
{
"belongToNewZt": 1,
"channelId": 0,
"channelName": "",
"count": 0,
"downs": 91,
"id": "5191539",
"image": "http://www1.pcauto.com.cn/app/5191539.jpg",
"preView": "新专题测试-列表1",
"pubDate": "2014-10-17",
"seq": 2,
"title": "新专题测试-列表1",
"to-uri": "pcautobrowser://information-article/5191539?belongToNewZt=1",
"type": 1,
"updateAt": 1413993600000,
"ups": 39
},
{
"belongToNewZt": 1,
"count": 0,
"downs": 0,
"forumName": "",
"id": "5334553",
"image": "http://www1.pcauto.com.cn/app/5334553.jpg",
"preView": "新专题测试-列表2",
"pubDate": "2014-10-23",
"seq": 3,
"title": "新专题测试-列表2",
"to-uri": "pcautobrowser://bbs-topic/5334553?belongToNewZt=1",
"type": 2,
"updateAt": 1413993600000,
"ups": 26
},
{
"belongToNewZt": 1,
"count": 0,
"downs": 0,
"forumName": "",
"id": "5334553",
"image": "http://www1.pcauto.com.cn/app/5334553.jpg",
"preView": "新专题测试 - 列表3",
"pubDate": "2014-09-25",
"seq": 5,
"title": "新专题测试 - 列表3",
"to-uri": "pcautobrowser://bbs-topic/5334553?belongToNewZt=1",
"type": 2,
"updateAt": 1413993600000,
"ups": 26
}
],
"channelName": "",
"downs": 0,
"image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3225.jpg",
"preView": "新专题测试",
"pubDate": "2014-10-10",
"seq": 1,
"title": "新专题测试",
"to-uri": "http://www.baidu.com?v=4.5.0&type=zt",
"type": 7,
"updateAt": 1413734400000,
"ups": 0
}
],
"topFocus": [
{
"cc-uri": "",
"image": "http://imgad0.pcauto.com.cn/ivy/image/20149/30/14120581638890.jpg",
"seq": 4,
"title": "广告",
"to-uri": "http://ivy.pcauto.com.cn/adpuba/click?adid=338019&id=auto.khd.zx.jdt4.",
"updateAt": 1414032230736,
"vc-uri": "http://ivy.pcauto.com.cn/adpuba/show?adid=338019&id=auto.khd.zx.jdt4.&media=js"
},
{
"cc-uri": "",
"image": "http://imgad0.pcauto.com.cn/ivy/image/20149/30/14120630969100.jpg",
"seq": 5,
"title": "广告",
"to-uri": "http://ivy.pcauto.com.cn/adpuba/click?adid=336496&id=auto.khd.zx.jdt5.",
"updateAt": 1414032230741,
"vc-uri": "http://ivy.pcauto.com.cn/adpuba/show?adid=336496&id=auto.khd.zx.jdt5.&media=js"
}
],
"total": 150
}
2.1.2 文章页终端
(接口已上线)
请求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.1.2.1 文章页标签跳转列表
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/cms/tag_articles?tagId=29&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:30分钟
说明:
请求参数:
tagId:标签id
pageNo:页码
pageSize:每页显示条数
返回结果:
返回数据格式和http://mrobot.pcauto.com.cn/v2/cms/channels/2?v=4.0.0&serialIds=&pageSize=250保持一致
2.1.3 地区选择
--已上线
请求url:http://mrobot.pcauto.com.cn/v2/cms/area_tree
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:7天
请求参数:
说明:
4.5版本 地区选择数据出全部数据,不从快搜拿了,从车型库拿所有的城市数据
返回结果:
{
"area": [
[
"529",
"昌吉",
"5401",
"新疆",
"昌吉市"
],
[
"526",
"哈密",
"5401",
"新疆",
"哈密市"
]
]
}
2.2.0 论坛首页-热门版块
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/hotForums
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:接口缓存
缓存时间:60分钟
请求参数:
snum:返回数据数量,如果不传,默认为9
说明:
请求后端url:http://bbs.pcauto.com.cn/intf/_hotForums.jsp?noForums=1,15673,15674,15675,2427,715,9999,16031&snum=9&p2=19&display=json&callback=json
返回结果:
[
{
"forumId": 19139,
"forumName": "比亚迪秦论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1309/12/c11/25593552_1378976095023_270x202.jpg",
"postCount": 317205,
"url": "http://bbs.pcauto.com.cn/forum-19139.html"
},
{
"forumId": 14674,
"forumName": "嘉年华论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
"postCount": 247368,
"url": "http://bbs.pcauto.com.cn/forum-14674.html"
},
{
"forumId": 17613,
"forumName": "马自达CX-5论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/06/c10/24195777_1375765250750_270x202.jpg",
"postCount": 144293,
"url": "http://bbs.pcauto.com.cn/forum-17613.html"
},
{
"forumId": 14144,
"forumName": "奥德赛论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/01/c4/36942311_36942311_1406867057125_800x600.jpg",
"postCount": 241257,
"url": "http://bbs.pcauto.com.cn/forum-14144.html"
},
{
"forumId": 14570,
"forumName": "凯越论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/17/c9/23421327_1374033864234_350x260.jpg",
"postCount": 443709,
"url": "http://bbs.pcauto.com.cn/forum-14570.html"
},
{
"forumId": 18685,
"forumName": "朗动论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/10/c4/12818185_12818185_1344587668078_270x202.jpg",
"postCount": 141326,
"url": "http://bbs.pcauto.com.cn/forum-18685.html"
},
{
"forumId": 15333,
"forumName": "轩逸论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1207/18/c1/12381268_12381268_1342621401348_270x202.jpg",
"postCount": 259080,
"url": "http://bbs.pcauto.com.cn/forum-15333.html"
},
{
"forumId": 15596,
"forumName": "明锐论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/20/c9/24674746_1376993577424_350x260.jpg",
"postCount": 999524,
"url": "http://bbs.pcauto.com.cn/forum-15596.html"
},
{
"forumId": 14150,
"forumName": "帕萨特论坛",
"icon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/08/c3/27088823_1381201677296_270x202.jpg",
"postCount": 190471,
"url": "http://bbs.pcauto.com.cn/forum-14150.html"
}
]
2.2.0.1 论坛首页-猜你喜欢
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/guessYouLike
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:接口缓存
缓存时间:60分钟
请求参数:第一次进到论坛首页的时候,既没有cookie,也没有visitedFid, 就使用热门论坛的,这个逻辑交给app客户端处理,由客户端调用热门论坛的接口获取数据拼接visitedFid
cookie
visitedFid:访问过的版块id以D分隔,非必须参数
请求后端url:http://bbs.pcauto.com.cn/intf/guessYouLike.do?smallImg=true&bbsImgOnly=true&type=json&imgCount=3&viewCount=true
说明:
picRule 图片模式:0为无图,1为有图
visitedFid 访问过的版块id以D分隔,非必须参数
type 输出格式,默认js,可以为json
var 当输出为js时,保存数据的变量名,默认为topiclist1
containCoverOnly 是否只出含封面图的精华,默认false
bbsImgOnly 是否只出汽车论坛上传的图片,默认false
smallImg 是否把图片转为120x80格式,默认false
imgCount 每个帖子出的图片数量,默认2
viewCount 值为true,表示出浏览数量
返回结果:(最多60个)
[
{
"datatime": "2014-04-25 11:04",
"datatimemillis": 1398395080000,
"desc": "买车过程太痛苦了!不想回忆了![无语]开始看过很多车,雅阁,CC,君越,胜达,3系,C级,还有蒙迪欧。蒙迪欧第一眼就爱上了,外形控的不二选择!高科技配置很多!完...",
"forum": "奥迪A4L论坛",
"forumId": 14034,
"forumlink": "http://v15.pcauto.com.cn/forum-14359.html",
"replycount": 100,
"topic": "40TFSI个运作业来了!谁说没媳妇合影就不能火!!!!!",
"topicId": 4720505,
"topicimg": [],
"topiclink": "http://v15.pcauto.com.cn/topic-4720505.html",
"userId": 30421242,
"userface": "http://i1.3conline.com/images/upload/upc/face/30/42/12/42/30421242_100x100",
"userlink": "http://v21.pcauto.com.cn/30421242",
"username": "qz30421242"
},
{
"datatime": "2014-04-09 23:51",
"datatimemillis": 1397058682000,
"desc": " 跟拍奥迪与嫩模今日独家奉上精美图集~名车名模,快说,你对哪个心动了呀? 啦啦啦,上图啦,看美女啦! [图]先来张内饰,甜甜圈是不是特别的显眼...",
"forum": "奥迪A4L论坛",
"forumId": 14034,
"forumlink": "http://v15.pcauto.com.cn/forum-14359.html",
"replycount": 39,
"topic": "【名模名车】奥迪或嫰模,你要哪个?多图杀猫~",
"topicId": 4639676,
"topicimg": [],
"topiclink": "http://v15.pcauto.com.cn/topic-4639676.html",
"userId": 8803955,
"userface": "http://i1.3conline.com/images/upload/upc/face/88/03/95/5/8803955_100x100",
"userlink": "http://v21.pcauto.com.cn/8803955",
"username": "爱恨不平行"
}
]
2.2.1 帖子列表
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/newForumsv45/14637?pageNo=1&pageSize=19&orderby=replyat&needImage=true&lastQuestionCreateAt=true
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:无
缓存时间:
说明:4.5版本增加一个提问帖,最多显示三张图,默认显示2条置顶帖,多出的列表隐藏起来,通过点击可以展开和收起,展开后最多只能5条。置顶帖的显示上,要和普通的帖子在样式和结构上有所不同
出精华帖和提问帖时,不需要出置顶帖
请求参数:
id:论坛ID或者车系id
idType:表示该url上的id类型,如果是serial为车系id,如果是forum则为论坛id
pageNo:页码
pageSize:一页条数
orderby=postat:最新发表,orderby=replyat:最近回复
filter: 不传filter出全部贴,filter=pick出精华贴,filter=question出提问贴
needImage=true 需要返回3张图片,添加此参数
lastQuestionCreateAt=true 接口返回最新一个提问贴的创建时间
返回结果:
{
"forum": {
"bbs": 19,
"favoriteId": -1,
"forumId": 14637,
"lastQuestionCreateAt": 1413273596000,
"name": "福克斯论坛",
"parentId": 298
},
"pageNo": 1,
"pageSize": 2,
"topTopics": [
{
"author": "岚",
"downs": 26,
"image": "http://img.pconline.com.cn/images/upload/upc/tx/bbs6/1310/08/c12/27106565_1381225461103_240x160.jpg",
"lastpostAt": 1382889600000,
"pubDate": "2013-10-28",
"replyCount": 242,
"seq": 5,
"title": "参加纽博格林挑战赛(长沙站)赢德国赛名额",
"topicId": 4122923,
"updateAt": 1382889600000,
"ups": 26,
"view": 95498
},
{
"author": {
"name": "岚",
"nickname": "岚",
"userId": 769104
},
"createAt": 1409821112000,
"downs": 0,
"flag": "图",
"image": "",
"lastPoster": "",
"replyCount": 41,
"title": "升级有礼 福特全系车友会1星奖励",
"topicId": 5267415,
"ups": 0,
"uri": "http://bbs.pcauto.com.cn/topic-5267415.html",
"view": 1270
},
{
"author": {
"name": "岚",
"nickname": "岚",
"userId": 769104
},
"createAt": 1378955022000,
"downs": 0,
"flag": "",
"image": "",
"lastPoster": "",
"replyCount": 254,
"title": "关于新老福漏油问题统计帖",
"topicId": 4065385,
"ups": 26,
"uri": "http://bbs.pcauto.com.cn/topic-4065385.html",
"view": 85774
},
{
"author": {
"name": "岚",
"nickname": "岚",
"userId": 769104
},
"createAt": 1341219694000,
"downs": 0,
"flag": "精",
"image": "",
"lastPoster": "",
"replyCount": 265,
"title": "经典福克斯 一看就会【维护秘笈】连载16篇 作者:路边花草[2014.5.11更新]",
"topicId": 3201819,
"ups": 39,
"uri": "http://bbs.pcauto.com.cn/topic-3201819.html",
"view": 106969
},
{
"author": {
"name": "秋楓落葉",
"nickname": "秋楓落葉",
"userId": 24994960
},
"createAt": 1344519070000,
"downs": 39,
"flag": "",
"image": "",
"lastPoster": "",
"replyCount": 635,
"title": "【福克斯】各地车友购车价格、礼品、油耗汇总贴(2014.1.13更新)",
"topicId": 3258772,
"ups": 78,
"uri": "http://bbs.pcauto.com.cn/topic-3258772.html",
"view": 550165
},
{
"author": {
"name": "马克威廉",
"nickname": "马克威廉",
"userId": 5533884
},
"createAt": 1268379259000,
"downs": 13,
"flag": "精",
"image": "",
"lastPoster": "",
"replyCount": 2188,
"title": "开个帖子,本人保险公司的,愿意为广大福友提供和保险相关的咨询",
"topicId": 2084149,
"ups": 65,
"uri": "http://bbs.pcauto.com.cn/topic-2084149.html",
"view": 175490
}
],
"topicList": [
{
"author": {
"name": "fit10",
"nickname": "sdffdsfdsf",
"userId": 826717
},
"createAt": 1410933846000,
"downs": 0,
"floor": 1,
"image": "http://www1.pcauto.com.cn/app/20131101/img/loading.png",
"images": [],
"isContainImage": false,
"isPick": false,
"isRecommend": false,
"lastpostAt": 1410933846000,
"replyCount": 0,
"title": "testaaaaaaaaaaaaaaaaaaaaaa",
"topicId": 4822355,
"ups": 0,
"uri": "http://dev11.pcauto.com.cn/bbs7/topic-4822355.html",
"view": 1
},
{
"author": {
"name": "fit10",
"nickname": "sdffdsfdsf",
"userId": 826717
},
"createAt": 1410933754000,
"downs": 0,
"floor": 1,
"image": "http://www1.pcauto.com.cn/app/20131101/img/loading.png",
"images": [],
"isContainImage": false,
"isPick": false,
"isRecommend": false,
"lastpostAt": 1410933754000,
"replyCount": 0,
"title": "testttttttt",
"topicId": 4822354,
"ups": 0,
"uri": "http://dev11.pcauto.com.cn/bbs7/topic-4822354.html",
"view": 1
}
],
"total": 73670
}
2.2.2 帖子终端
--已上线
请求url:http://mrobot.pcauto.com.cn/v2/bbs/topics/5307465?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
请求后端url:http://bbs.pcauto.com.cn/rest/topics/5307465?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:无
缓存时间:
说明:4.5版本增加删帖,加精,评分功能
请求参数:
common_session_id:登录后的session,Cookies传值
帖子ID
pageNo:页码
pageSize:一页条数
picRule:获取图片的网络访问方式
authorId:作者ID
topicTemplate=4.0.0
app=pcautobrowser
size:字体大小
mode:阅读模式:无参数 白天;night 晚间
返回结果:
删帖点击协议: pcaction://delete-post/帖子id
加精点击协议: pcaction://add-to-digest/帖子id
评分点击协议: pcaction://add-score/帖子id?floorId=楼层id&authorId=楼层作者id
2.2.3 删帖
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/deleteTopic
请求后端url:http://bbs.pcauto.com.cn/action/topic/delete.do
HTTP请求方式:POST
是否需要登录:true
返回格式:json
缓存方式:无
缓存时间:
说明:
请求参数:
cookie
tid:帖子ID
ajax:true,客户端不用传
返回结果:
未登录:status=6
被锁:status=7
其他都是抛出异常,然后统一处理,所以code、status一样
{
"deleteInfo": [
{
"desc": "删除主题成功",
"fid": 20886,
"status": 0
}
]
}
{
"deleteInfo": [
{
"code": "0000001",
"desc": "您所在的用户组【太平洋舰队少校】没有删除帖子的权限,请与管理员联系。",
"status": -1
}
]
}
2.2.4 加精
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/pick
请求后端url:http://bbs.pcauto.com.cn/action/topic/pick.ajax
HTTP请求方式:POST
是否需要登录:true
返回格式:json
缓存方式:无
缓存时间:
说明:
请求参数:
cookie
json:包括如下数据{
tids:批量主题帖ID,多个以逗号间隔
target:设置(1)还是取消(0),传1
type:精华类别(精华1--pickA、精华2--pickB)
pickClassify: 精华分类(提车作业--1、改装集锦--2、自驾游--3、用车养护--4、车友趣事--5、行行摄摄--6、其他--7)
exttype:(首页推荐--pick1、快秀广告--pick2、推荐帖--pick3、高富帅帖--pick4、白富美--pick5),不用传
reason:原因
fid:板块ID
sendmsg:是否发消息给作者
cover:封面URL,不用传
ajax:true,不用传
}
样例:
json = {"tids":"4822476","fid":"20886","target":"1","type":"pickB","pickClassify":"1","reason":"原因","sendmsg":"true"}
返回结果:
未登录:status=6
被锁:status=7
其他都是抛出异常,然后统一处理,所以code、status一样
{
"pickInfo": [
{
"desc": "设置成功",
"status": 0
}
]
}
{
"pickInfo": [
{
"code": "0000001",
"desc": "没有设置精华的权限",
"status": -1
}
]
}
2.2.5 评分
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/grade
请求后端url:http://bbs.pcauto.com.cn/action/post/grade.ajax
HTTP请求方式:POST
是否需要登录:true
返回格式:json
缓存方式:无
缓存时间:
说明:
请求参数:
cookie
json:包括如下数据{
tid:帖子ID
fid:板块ID
pids:评分楼层ID,如多个则用逗号间隔
sendmsg:回复是否发消息,true/false
scoreName2:评的分数(馒头)
}
样例:
json = { "fid": "20886", "tid": "4822476", "pids": "46765224", "sendmsg": "true","scoreName2": "1" }
返回结果:
未登录:status=6
被锁:status=7
其他都是抛出异常,然后统一处理,所以code、status一样
{
"gradeInfo": [
{
"desc": "操作成功",
"status": 0
}
]
}
{
"gradeInfo": [
{
"desc": "请登录后操作",
"status": 6
}
]
}
{
"gradeInfo": [
{
"code": "0000001",
"desc": "您对此帖已经评过贡献(馒头)",
"status": -1
}
]
}
2.2.5.1 用于获取用户实时分数
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/getCurScore?fid=16855&tid=4821844&pid=46764712
请求后端url:http://bbs.pcauto.com.cn/app/intf/user/grade.do?fid=16855&tid=4821844&pid=46764712
HTTP请求方式:GET
是否需要登录:true
返回格式:json
缓存方式:无
缓存时间:
说明:用户分数取馒头,用户的分数是对应到每一个楼层的,楼层如果评过了,就会没有数据,没有评过,就是剩余的分数了
用于获取用户的分数
请求参数:
cookie:必须
fid:版块ID,必须
tid:帖子ID,必须
pid:回帖ID,必须
返回结果:
{
"scoreName1": "积分(大米)",
"scoreName1-value": 0,
"scoreName2": "贡献(馒头)",
"scoreName2-value": 30,
"status": 0
}
2.2.6 精华设置
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/pickSettings
请求后端url:http://bbs.pcauto.com.cn/app/intf/config/pick.do
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:无
缓存时间:
说明:
用于取设置精华的选项
pickClassifysArray 精华类型
pickConfigArray 精华
请求参数:
返回结果:
{
"extPickConfigArray": [
{
"enable": 1,
"name": "首页推荐",
"value": "pick1"
},
{
"enable": 1,
"name": "快秀广告",
"value": "pick2"
},
{
"enable": 1,
"name": "推荐帖",
"value": "pick3"
},
{
"enable": 1,
"name": "高富帅帖",
"value": "pick4"
},
{
"enable": 1,
"name": "白富美",
"value": "pick5"
}
],
"pickClassifysArray": [
{
"name": "提车作业",
"value": "1"
},
{
"name": "改装集锦",
"value": "2"
},
{
"name": "自驾游",
"value": "3"
},
{
"name": "用车养护",
"value": "4"
},
{
"name": "车友趣事",
"value": "5"
},
{
"name": "行行摄摄",
"value": "6"
},
{
"name": "其他",
"value": "7"
}
],
"pickConfigArray": [
{
"enable": 1,
"name": "精华1",
"value": "pickA"
},
{
"enable": 1,
"name": "精华2",
"value": "pickB"
}
]
}
2.3.0 搜索关键词提示
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/search/tips?keyword=大z
后端请求url:http://ks.pcauto.com.cn/searchSuggest2.shtml?responseEncoding=utf-8&app=composite&q=Jeep
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:对象缓存
缓存时间:1分钟
说明:
isSerialGroup //是否是车系
state:
请求参数:
keyword:keyword参数要在客户端两次编码
responseEncoding:指定响应体编码
返回结果:
[
{
"keyword": "大众"
},
{
"keyword": "大迪"
},
{
"keyword": "道奇"
},
{
"keyword": "大众(进口)"
},
{
"isSerialGroup": true,
"keyword": "朗逸",
"price": "9.78-15.79万",
"sid": "3225",
"state": "3"
},
{
"isSerialGroup": true,
"keyword": "途观",
"price": "19.97-31.57万",
"sid": "3895",
"state": "3"
},
{
"isSerialGroup": true,
"keyword": "速腾",
"price": "12.08-18.53万",
"sid": "1633",
"state": "3"
},
{
"isSerialGroup": true,
"keyword": "宝来",
"price": "9.88-13.13万",
"sid": "3286",
"state": "3"
},
{
"isSerialGroup": true,
"keyword": "捷达",
"price": "7.28-9.88万",
"sid": "89",
"state": "3"
},
{
"isSerialGroup": true,
"keyword": "帕萨特",
"price": "15.98-29.88万",
"sid": "99",
"state": "3"
}
]
2.3.1 搜索结果-综合
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/search/composite?keyword=大众
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:对象缓存
缓存时间:1分钟
说明:
1、出相关车系的车系页中的“文章”版块的内容,优先出必看文章,再按时间出最新相关文章,最多外显3篇。
2、如果车系页中没有相关文章,则通过快搜按关键字搜索相关的文章进行填充
请求参数:
keyword:搜索的关键词
返回结果:
{
"keyword": "如果是模糊搜索出来的,这个keyword会和请求参数的keyword不一样",
"serial": {
"serialId": 3404,
"serialName": "福克斯",
"price": "9.98-16.99万",
"image": "http:\/\/img.pconline.com.cn\/images\/upload\/upc\/tx\/auto5\/1307\/24\/c16\/23702964_1374654889218_270x202.jpg",
"cars": [
{
"id": "33318",
"price": "23.10", (官方价)
"title": "2015款 1.8 30TFSI 手动舒适型",
}
]
},
"manufacturer": {
"brandId": 21,
"brandName": "福特",
"serials": [
{
"id": 7889,
"name": "起亚K3",
"priceRange": "10.28~14.98万"
}
]
},
"topics": [
{
"authorId": 22393072,
"authorName": "hkitty",
"pubDate": “2014-08-26”,
"topicId": 5098712,
"topicTitle": "普通帖子",
"answerCount": 12提问帖中回答的人数,非提问帖可以不用这个
}
],
"articles": [
{
"channelId": 2,
"channelName": "新车",
"id": "5023924",
"pubDate": "2014-08-26",
"title": "野马F16将成都车展上市 并发布全新LOGO",
"url": "http://www.pcauto.com.cn/nation/502/5023924.html"
}
],
"hotPKCars": [
{
"id": "33318",
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/01/c0/14229062_14229062_1349107127921_120x90.jpg",
"title": "2015款 1.8 30TFSI 手动舒适型",
"price": "23.10~27.28" (官方价)
}
]
}
2.3.1.1 搜索结果-帖子
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/search/ksauto_bbs?keyword=大众&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:对象缓存
缓存时间:1分钟
说明:
1、出相关车系的车系页中的“文章”版块的内容,优先出必看文章,再按时间出最新相关文章,最多外显3篇。
2、如果车系页中没有相关文章,则通过快搜按关键字搜索相关的文章进行填充
请求参数:
keyword:搜索的关键词
clusterQuery: 文章分类(直接搜中文)
sort:排序方式(不填则默认最相关,time:最新发布,access:最热门)
searchTime:发布时间(不填则搜全部时间,year:一年内,month:一个月内,week:一周内)
pageNo:页数 (可不传,默认为1)
bbsType:帖子类型(不填则默认全部类型,isPick:精华帖,isPhotosNum:图片帖)
返回结果:
{
"keyword": "如果是模糊搜索出来的,这个keyword会和请求参数的keyword不一样",
"topics": [
{
"authorId": 22393072,
"authorName": "hkitty",
"pubDate": "2014-08-26",
"topicId": 5098712,
"topicTitle": "普通帖子",
"answerCount": 12提问帖中回答的人数,非提问帖可以不用这个
}
],
"types": [
{
"name": "全部论坛"
}
],
"bbsInfo": {
"forumId": 16040,
"forumName": "朗逸论坛",
"sid": 3225, //车系ID
"topicTotal": 525125 //论坛总数
}
}
2.3.1.2 搜索结果-文章
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/search/ksauto_cms?keyword=大众&city=广州&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:对象缓存
缓存时间:1分钟
说明:
1、出相关车系的车系页中的“文章”版块的内容,优先出必看文章,再按时间出最新相关文章,最多外显3篇。
2、如果车系页中没有相关文章,则通过快搜按关键字搜索相关的文章进行填充
请求参数:
keyword:搜索的关键词
clusterQuery: 文章分类(直接搜中文)
sort:排序方式(不填则默认最相关,time:最新发布,access:最热门)
searchTime:发布时间(不填则搜全部时间,year:一年内,month:一个月内,week:一周内)
city:城市(行情时选择的城市,分类是行情时才用到)
pageNo:页数 (可不填,不填默认为1)
返回结果:
{
"keyword": "如果是模糊搜索出来的,这个keyword会和请求参数的keyword不一样",
"articles": [
{
"channelId": 2,
"channelName": "新车",
"id": "5023924",
"pubDate": "2014-08-26",
"title": "野马F16将成都车展上市 并发布全新LOGO",
"url": "http://www.pcauto.com.cn/nation/502/5023924.html"
}
],
"types": [
{
"name": "全部"(两个字)
}
],
"citys" : [
{
"count" : 123 , (该城市下结果数量)
"name":"北京",(城市名称)
}
]
}
2.4.0 车型库首页
请求url:http://mrobot.pcauto.com.cn/v3/price/modelLibraryHomePage?bid=3
原地址(在线):
原始地址(开发):http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=3&type=3
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:1分钟
说明:增加status,用于区分在售分类
请求参数:
bid品牌id
type=3
备注:type=3表示出非假想车,即包括在售、未上市、在售、即将上市;新上市;概念车;海外车
返回结果:
{
"manufacturers": [
{
"brandIntroduction": "http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html",
"brandName": "奥迪",
"name": "一汽奥迪",
"serials": [
{
"count": 41,
"id": 3524,
"isNew": 0, //isNew = 1表示新上市
"kind": "中型车",
"name": "奥迪A4L",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
"priceRange": "27.28~57.81 万", //价格状态 priceRange:1、有价格就出价格;2、国内未发售;3、未量产发售;4、暂无报价
"sellStatus": 3 //1停售 2未上市 3在售 4即将上市
"carVersion": 1, //1量产车 2概念车
"carField": 4 //1海外 234非海外
}
]
}
]
}
2.4.0.1 热销排行
Mrobot正式URL : http://mrobot.pcauto.com.cn/buy/price/hotSellSerials/1?pageNo=1&pageSize=20
请求后端URL(开发): http://v17.pcauto.com.cn:8002/interface/iphone/praiselist_by_kindId.jsp?kindId=1&pageNo=1&pageSize=10
请求后端URL(线上): http://price.pcauto.com.cn/interface/iphone/praiselist_by_kindId.jsp?kindId=3&pageNo=1&pageSize=10
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:1分钟
说明:新增
请求参数:
kindId: 请求类型 // 1~8分别代表:紧凑型车、SUV、中型车、小型车、微型车、中大型车、豪华型车、MPV
pageNo :请求分页
pageSize :请求分页大小
do:
isNew == 1 就是表示新上市
sellStatus 1:停售,2:未上市,3:在售,4:即将上市
返回结果:
{
"list": [
{
"isNew": 0,
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3544.jpg",
"price": "9.99~16.99万",
"sellStatus": 3,
"serialGroupId": "3544",
"serialGroupName": "科鲁兹"
},
{
"isNew": 0,
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_2734.jpg",
"price": "10.78~15.98万",
"sellStatus": 3,
"serialGroupId": "2734",
"serialGroupName": "卡罗拉"
},
{
"isNew": 0,
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3404.jpg",
"price": "9.98~16.99万",
"sellStatus": 3,
"serialGroupId": "3404",
"serialGroupName": "福克斯"
}
],
"pageNo": 1,
"pageSize": 3,
"total": 156
}
2.4.0.2 图片对比
Mrobot正式URL : http://mrobot.pcauto.com.cn/v2/price/pictureContrast?modelId1=22519&modelId2=22521
请求后端URL(开发): http://dev3.pcauto.com.cn:8001/interface/iphone/photo_compare_list.jsp?modelId1=22519&modelId2=22521
请求后端URL(线上): http://price.pcauto.com.cn/interface/iphone/photo_compare_list.jsp?modelId1=22519&modelId2=22521
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:
说明:(新增 )传车型id,获取所有对比图片
请求参数:
modelId1 // 车型id1
modelId2 // 车型id2
返回结果:
{
"datas":
[
{
"typeId":"", //大类id,(外观:1; 外观细节:2; 中控:3; 车厢座椅:4; 其他细节:5)
"typeName": "外观", //大类名称:外观、外观细节、中控、车厢座椅、其他细节
"total": 10, //大类下的图片组数
"modelName1":"福克斯 2012款 两厢 1.6L 手动舒适型",
"modelName2": "福克斯 2012款 两厢 1.6L 手动舒适型",
"photos":
[
{
"photoUrl1": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/09/c17/14331978_14331978_1349769669282_400x300.jpg",
"photoUrl2": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/09/c17/14331978_14331978_1349769669282_400x300.jpg"
},
{
"car1Url": "", //图片url,没有图片则为空
"car2Url": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/09/c17/14331978_14331978_1349769669282_400x300.jpg"
},
{
"car1Url": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/09/c17/14331978_14331978_1349769669282_400x300.jpg",
"car2Url": "" //图片url,没有图片则为空
}
]
}
...
]
}
2.4.0.3 图片对比-选车-品牌选车
Mrobot正式URL : http://mrobot.pcauto.com.cn/v2/price/brands?v=picCompare
请求后端URL(开发): http://dev3.pcauto.com.cn:8001/interface/iphone/chooser/brand_json_chooser.jsp
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
说明:新增
请求参数:
无
返回结果:
{
"sections": [
{
"brands": [
{
"id": 1,
"logo": "http://www1.pcauto.com.cn/piclib/1.png",
"name": "奥迪"
},
…
],
"index": "A",
"rowNum": 5
}
…
]
}
2.4.0.4 图片对比-选车-车系选车
Mrobot正式URL : http://mrobot.pcauto.com.cn/v3/price/serialChooser?bid=693
请求后端URL(开发): http://dev3.pcauto.com.cn:8001/interface/iphone/chooser/serial_json_chooser.jsp?brand=1
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
说明:新增
请求参数:
bid =品牌id
返回结果:
{
"manufacturers": [
{
"name": "AC宝马",
"serials": [
{
"id": 7792,
"kind": "中大型SUV",
"name": "AC M5 700",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_7792.jpg",
"priceRange": "348 万",
"sellStatus": "3"
},
...
]
}
]
}
2.4.0.5 图片对比-选车-车型选车
Mrobot正式URL : http://mrobot.pcauto.com.cn/v3/price/modelChooser/7792
请求后端URL(开发):http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/4313
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
说明:新增
请求参数:
modelChooser/7792 车系id
返回结果:
{
"sections": [
{
"data": [
{
"config": "手自一体 四轮驱动 车身稳定控制 天窗",
"firm": "8751",
"id": "19105",
"photo": "http://img.pconline.com.cn/images/20891613_1368494957173_120x90.jpg",
"plTitle": "车型信息",
"price": "348.0",
"status": "在售",
"text": "AC M5 700 2012款 四驱 基本型",
"title": "AC M5 700 2012款 四驱 基本型"
}
],
"status": "在售",
"title": "车型信息"
}
]
}
2.4.1 车系综述页
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/price/serialv45/7929?rid=1
原地址:http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId={serialId}&rid={rid}&version=2
竞争车型对比接口:http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId={serialId}&size=3
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:1分钟
说明:
新增图片、点评、团购、经销商、购车计算等入口
请求参数:
车系id
rid:地区id
version版本控制,这里version=2,表示app4.5
size:个数,最多20个
modelIds:已加入对比的车型id,多个id用,隔开
返回结果:
点击图片协议: pcaction://goto-pic/
点击团购协议: pcautobrowser://activity/6254活动id
点击车系询底价协议:pcautobrowser://auto-ask-price/
点击点评协议: pcaction://goto-comment/
点击经销商协议: pcaction://goto-dealer/
点击车型:pcautobrowser://model/33876
点击车型加入对比:pcaction://compare/?modelId=33876&modelName=xx
点击车型取消对比:pcaction://decompare/?modelId=33877&modelName=xx
提供函数setCompared(modelId,compare),去掉对比compare为0,加入对比compare为1
点击车型询底价:pcautobrowser://auto-ask-price/?modelId=33876&modelName=xx&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1308%2F14%2Fc10%2F24479672_1376473605447_120x90.jpg
点击车型购车计算: pcautobrowser://calculate-cost?modelId=1&modelName=xx&modelPrice=100000
竞争车系部分的协议:
1、点击车系:pcautobrowser://serial/车系id?name=车系名称
2、点击对比/取消对比按钮:默认选择竞争车系中最热门的车型进行参数对比
点击车型加入对比:pcaction://compare/?modelId=33876&modelName=xx&serialName=xx
点击车型取消对比:pcaction://decompare/?modelId=33877&modelName=xx&serialName=xx
提供函数setCompared(modelId,compare),去掉对比compare为0,加入对比compare为1
在源代码中添加车系相关数据
/*@_HTML_META_START_
{"img":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/06/c29/28385302_1383740867046_120x90.jpg","priceRange":"10.78~16.59万","serialId":"3225","serialName":"朗逸"}
_HTML_META_END_@*/
2.4.2 车系参配页
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/price/detailComparev45?serialId=7929&v=4.5.0
http://mrobot.pcauto.com.cn/v3/price/detailComparev45?id1=0&id2=0&v=4.5.0(具体车型对比)
原地址:http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid={modelId}
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:无
缓存时间:
说明:
原有接口:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?serialId=7929&v=4.3.0
样式调整、滚动时增加协议
请求参数:
serialId:车系id
id1、id2:比对的车型id
返回结果:
滚动到对应section时,触发协议: pcaction://show-section/${类型名}
提供一个js函数gotoSection(index),调用后跳转到对应的锚点
源代码中,加入
/*@_HTML_META_START_
{"types":[{"anchor":"锚点名字","name":"类型名"}]}
_HTML_META_END_@*/
2.4.3 车系优惠(降价)列表
2.6.0 降价列表 按最大降幅
2.4.3.1 车系优惠详情页
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/price/promotionDetailv45/5153273?modelId=30499&type=0
原地址:
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:
原有接口:http://mrobot.pcauto.com.cn/v3/price/promotionDetail/5676254?modelId=34616
请求参数:
优惠行情id
type:请求的优惠页样式:type=0指请求车系降价列表的优惠页;type=1指请求经销商详情优惠列表的优惠页
modelId:车型id,type=0的时候需要传此参数
返回结果:
页面协议:
1、电话咨询:pcaction://webview_tel/电话号码(如400-860-0903)
2、我要优惠:pcautobrowser://auto-get-promotion/?serialId=1633&serialName=%E9%80%9F%E8%85%BE&modelId=32972&modelName=%E9%80%9F%E8%85%BE+2014%E6%AC%BE+%E6%94%B9%E6%AC%BE+1.4TSI+DSG+%E8%B1%AA%E5%8D%8E%E5%9E%8B+&dealerId=64182&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1310%2F10%2Fc11%2F27274580_1381378280296_400x300.jpg
3、点击公司:pcautobrowser://agents-detail/?dealerId=15332
4、点击地址:pcautobrowser://abc-map/?jing=&wei=&name=&address=
5、点击咨询热线:pcaction://webview_tel/电话号码(如400-860-0903)
源码加优惠相关信息:
/*@_HTML_META_START_
{"newTitle":朗逸现金优惠0.78万现车充足全市最低,"newImg":http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/17/c0/29706419_1387245717615_400x300.jpg,"newDes":广州冠晔店内朗逸现车充足,近期购车最高优惠0.78万。感兴趣的朋友不妨拨打咨询热线400-881-0675或到店咨询。活动仅限本周。网络客户私人定制促销价格。最终解释权由冠晔所有,该活动仅限电话预约,网销VIP专享热线,只要您敢询价,我们就敢报低价。}
_HTML_META_END_@*/
2.4.4 车系点评页
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/price/serialCommentList/3404
请求后端url:http://price.pcauto.com.cn/interface/iphone/detail_comments_group.jsp?serialGroupId=3404
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:15分钟
说明:
区分在售、停售,不分页
请求参数:
车系id
返回结果:车系点评页
页面协议:点击车型点评:pcautobrowser://pcauto-owner-review/?modelId=22605
2.4.5 车系车型图片筛选条件
--已上线
请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0&v=4.5.0
请求后端地址:http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp?serialId={serialId}&modelId={modelId}&version=2
测试环境地址:http://dev3.pcauto.com.cn:8001/interface/iphone/photo_choose_option.jsp?serialId={serialId}&modelId={modelId}&version=2
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
说明:
types增加字段section,用于细化外观
colors字段增加颜色值
请求参数:
serialId:车系id
modelId: 车型id,查车系的时候不用传
v:4.5.0 4.5版本增加类型细化,颜色值
返回结果:
2.4.6 车系\车型图片
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=7889&pageSize=1497&typeId=1&cateId=10&colorId=0&modelId=0&v=4.5.0
原地址:http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?typeId=1&serialGroupId=7889&modelId=0&colorId=0&pageSize=1497&pageNo=1
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
说明:
typeId被细化,增加外观分类
原有车系图片接口: http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=7889&pageSize=1497&typeId=1&colorId=0&modelId=0
请求参数:
serialId // 车系id
modelId // 车型id
typeId // 图片类型id
cateId // 图片类型细分id(不传默认为全部)
colorId // 颜色id
v // 值为4.5.0时图片类型细分
pageNo //第几页
pageSize //每页显示多少条
返回结果:
{
"sections": [
{
"title": "外观",
"photos": [
{
"bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1407/24/c16/36663887_36663887_1406193782359_400x300.jpg",
"smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1407/24/c16/36663887_36663887_1406193782359_120x90.jpg"
}
]
}
]
}
2.4.6.1 车系\车型全部type分类图片信息
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v2/price/nav_pictures?serialGroupId=3544&modelId=31532&colorId=15672
原地址:http://dev3.pcauto.com.cn:8001/interface/iphone/photo_category_list.jsp?serialGroupId=3544&modelId=31532&colorId=15672
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
说明:
返回全部type分类的图片信息
请求参数:
serialGroupId// 车系id
modelId // 车型id
colorId // 颜色id
返回结果:
{
sections: [
{
photos: [
{
bigPath: "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1405/27/c4/34667244_1401163188516_400x300.jpg",
smallPath: "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1405/27/c4/34667244_1401163188516_120x90.jpg"
}
],
title: "外观",
total: 1
}
2.4.7 车系经销商
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv45?serialId=7929&areaId=1
请求后端url:http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?serialId=7929&areaId=1&pageSize=25&pageNo=1&mapType=2&dealerType=1
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:
请求参数:
serialId:车系id
areaId:地区id
mapType:出百度地图坐标,客户端不用传
dealerType:出全部经销商,客户端不用传
返回结果:
在HTML源码里,加入全部经销商的数据json,包括地址&百度地图坐标
/*@_HTML_META_START_
{"dealer":[{}]}
_HTML_META_END_@*/
协议如下:
点击电话:pcaction://webview_tel/电话号码(如400-860-0903)
点击询底价:pcautobrowser://auto-ask-price/?modelId=33876&modelName=%E8%B5%B7%E4%BA%9AK3+2015%E6%AC%BE+1.6+%E6%89%8B%E5%8A%A8GL&dealerId=15407&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1308%2F14%2Fc10%2F24479672_1376473605447_120x90.jpg
点击位置信息:pcautobrowser://abc-map/?jing=113.36269383788195&wei=22.987620058096958&name=%E7%B2%A4%E6%A0%87%E4%B8%9C%E9%A3%8E%E6%82%A6%E8%BE%BE%E8%B5%B7%E4%BA%9A&address=%E5%B9%BF%E5%B7%9E%E7%95%AA%E7%A6%BA%E8%BF%8E%E5%AE%BE%E5%A4%A7%E9%81%93%E4%B8%AD%E7%91%9E%E5%8D%8E%E6%B1%BD%E8%BD%A6%E5%9F%8E%E3%80%82%E4%B9%98%E8%BD%A6%E7%BA%BF%E8%B7%AF%3A1.%E5%AE%8F%E5%9F%8E%E5%B9%BF%E5%9C%BA%EF%BC%8D%E5%8D%8E%E5%8D%97%E7%A2%A7%E6%A1%82%E5%9B%AD%E5%85%8D%E8%B4%B9%E6%A5%BC%E5%B7%B4%E3%80%822.301%E3%80%81302%E5%85%AC%E4%BA%A4%E7%9B%B4%E8%BE%BE%E3%80%823.%E5%8D%8E%E5%8D%97%E5%BF%AB%E7%BA%BF20%E5%88%86%E9%92%9F%E8%BD%A6%E7%A8%8B%E6%88%96%E6%B4%9B%E6%BA%AA%E5%A4%A7%E6%A1%A5%EF%BC%8D%E8%BF%8E%E5%AE%BE%E8%B7%AF
点击经销商:pcautobrowser://agents-detail/?dealerId=30716
2.4.7.1 经销商(车系)详情
--已上线
请求url:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv45?dealerId=15075
请求后端url:
经销商详情:http://price.pcauto.com.cn/dealer/interface/app/dealer_info_json.jsp?dealerId=15075&type=1
在售车系列表:http://price.pcauto.com.cn/dealer/interface/app/dealer_serialgroup_json.jsp?dealerId=15075&pageSize=100&pageNo=1
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:
原有接口:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&seq=154070001&modelName=%E8%B5%B7%E4%BA%9AK3%202015%E6%AC%BE%201.6%20%E6%89%8B%E5%8A%A8GL&v=4.3.0&modelId2=33876&serialId=7889&dealerPrice=10.28
请求参数:
dealerId:经销商id
返回结果:
协议:
1、点击公司:pcautobrowser://getDealerDetail/经销商id
2、点击地址:pcautobrowser://abc-map/?jing=&wei=&name=&address=
3、点击咨询热线:pcaction://webview_tel/电话号码(如400-860-0903)
4、点击预约试驾:pcautobrowser://pcauto-appoint4driving/
5、点击询底价:pcautobrowser://auto-ask-price/?dealerId=15407
6、点击促销优惠:pcautobrowser://car-preferential-detail-list/15407经销商id
7:点击在售车系:pcautobrowser://car-preferential-on-sale-serial/2323车系id?serialType=车系类型(如中型车)&dealerId=
源代码中,加入经销商的相关数据:
/*@_HTML_META_START_
{"dealerAddress":"大观路新店:广州市天河区大观南路63号(航天奇观公交站旁);",
"dealerId":30830,
"dealerName":"广州冠晔",
"is4S":true}
_HTML_META_END_@*/
2.4.7.2 经销商(车系)详情的促销优惠列表
未上线,可连192.168.22.145进行测试
请求url:http://mrobot.pcauto.com.cn/v3/price/dealerNewMesv45/{dealerId}?pageSize=20&pageNo=1
请求后端url:
http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp?pageSize=20&pageNo=1&dealerId=50680
HTTP请求方式:GET
是否需要登录:false
返回格式:json
缓存方式:无
说明:
此接口用于获取经销商的促销优惠信息,V4.5之前该列表存在web页中,如:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&seq=506800001&modelName=%E5%A5%A5%E8%BF%AAA4L%202015%E6%AC%BE%201.8%2030TFSI%20%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&v=4.3.0&modelId2=33318&serialId=3524&dealerPrice=27.28
请求参数:
dealerId:经销商id
pageSize 分页条数
pageNo 第几个分页
返回结果:
返回Json数据
{
"datas": [
{
"content": "智尊生活 粤奥奥迪A5最高优惠8.78万",
"date": "2014-10-23",
"id": "5996316",
"serialGroupId": "4438",
"url": "http://m.pcauto.com.cn/auto/market/50680-5996316.html"
},
{
"content": "智尊生活 粤奥奥迪A1最高优惠5.5万",
"date": "2014-10-23",
"id": "5995586",
"serialGroupId": "3746",
"url": "http://m.pcauto.com.cn/auto/market/50680-5995586.html"
},
{
"content": "智尊生活 粤奥购奥迪Q7钜惠送豪礼",
"date": "2014-10-23",
"id": "5995409",
"serialGroupId": "1933",
"url": "http://m.pcauto.com.cn/auto/market/50680-5995409.html"
},
{
"content": "智尊生活 粤奥奥迪A6L钜惠15.33万",
"date": "2014-10-23",
"id": "5995195",
"serialGroupId": "4313",
"url": "http://m.pcauto.com.cn/auto/market/50680-5995195.html"
},
{
"content": "奥迪A4L最高优惠6.9万 有少量现车",
"date": "2014-10-22",
"id": "5981802",
"serialGroupId": "3524",
"url": "http://m.pcauto.com.cn/auto/market/50680-5981802.html"
}
],
"pageCount": 5,
"pageNo": 1,
"pageSize": 5,
"total": 25
}
2.4.8 公司介绍
接口已上线。
请求url:http://mrobot.pcauto.com.cn/v3/price/getDealerDetail/{dealerId}?type=2
原地址:http://m.pcauto.com.cn/dealer/interface/app/dealer_info_json.jsp?dealerId="
//+ dealerId + "&type=" + type + "&refrest=ad";
+ dealerId + "&type=" + type;
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:新增
请求参数:
dealerId:经销商ID
type:类型,type=1返回json类型,其他情况是页面展现形式
返回结果:
type=1时,result:
{
"address": "广州市珠江新城临江大道57号南雅中和广场首层",
"aq": 1,
"id": 19375,
"is400": 0,
"lat": "23.119781472953104",
"lng": "113.33491071084285",
"name": "广州宾利汽车贸易有限公司",
"phone": "020-38035099",
"shortName": "广州宾利",
"vip": 1
}
type=1时,页面显示,数据中不存在荣誉资格数据时,荣誉部分div不显示
2.4.9 询底价页
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v3/price/askpricev45?serialId=89&modelId=19792&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/11/c3/14373198_14373198_1349942613212_120x90.jpg
原地址:http://price.pcauto.com.cn/interface/iphone/dealer_enquiry.jsp?modelId=19792&dealerId=49712&provinceId=%u5E7F%u4E1C®ionId=1&name=%u59D3%u540D&phone=13812345678&origin=3
车型数据请求:http://mrobot.pcauto.com.cn/v3/price/askpricev45mcc?serialId=89 缓存24小时
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:无
缓存时间:
说明:
请求参数:
serialId:车系id
modelId:车型id
modelName:车型名称
url:车型图片链接
dealerId:经销商id(如有指定经销商,则客户端不需要调用getDealers,如无指定经销商即没传此参数,则调用getDealers以显示经销商列表)
阅读模式:无参数 白天;night 晚间
返回结果:
点击车型选择协议: pcaction://choose-car/json={"cars":[{"id":1, name:"车型名字"}]}
点击地址选择协议: pcaction://location/
定义三个js函数:
setlocation(regionId,regionName) ;调用效果:设置地址,regionId(城市id),regionName(城市名称)
setCar(modelId,modelName,url);调用效果:设置车型,modelId(车型id),modelName(车型名称),url(车型图片地址)
getDealers(regionId,serialId);调用效果:获取生成可选经销商,regionId(城市id),serialId(车系id)
在HTML源码里,加入(指定经销商)在售可选车型数据
/*@_HTML_META_START_
{cars:[{title: " 1.4L 90马力",data:
[{id: "24433",title: "2013款 1.4 手动时尚型",price: "8.28",config: "5挡手动 前置前驱 ",},{id: "24434",title: "2013款 1.4 手动舒适型",price: "9.28",config: "5挡手动 前置前驱 天窗",}]},{title: " 1.4L 90马力",data:
[{id: "24433",title: "2013款 1.4 手动时尚型",price: "8.28",config: "5挡手动 前置前驱 ",},{id: "24434",title: "2013款 1.4 手动舒适型",price: "9.28",config: "5挡手动 前置前驱 天窗",}]}]}
_HTML_META_END_@*/
2.4.10 精准选车条件结果
(接口已上线)
请求url:http://mrobot.pcauto.com.cn/v2/price/models/search?jb=72&pl=4&bsx=3&pz=3_5_1&ps=13&pe=30&version=2&pageNo=1&pageSize=20&v=4.5.0
原地址:http://price.pcauto.com.cn/interface/iphone/query_serial_group.jsp?price=7&jb=72&pl=4&bsx=3&bid=0&country=0&mkid=0&qdfs=0&jq=0&carf=0&rl=0&zw=0&isCz=0&pz=0&ps=0&pe=0&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:无
缓存时间:
说明:
原有接口: http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&pageSize=20&v=4.3.0
原有接口使用的price是http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.3.0接口中取的index,但4.5版本使用的价格是可以自定义范围的不适用,这个参数要改
同样配置的参数:pz的值也是取其index,4.5要改成可多选,
注:新接口要以车系区分,一个车系下的都在cars里面
请求参数(对比4.3.0增加以下):
ps //自定义最低价
pe //自定义最高价
pz=3_5 //配置,表示多选3&5
version //控制返回json版本,version=2表示4.5.0
返回结果:
{
"serial": [{
"serialId": 3404,
"serialName": "福克斯",
"price": "9.98-16.99万",
"image": "http:\/\/img.pconline.com.cn\/images\/upload\/upc\/tx\/auto5\/1307\/24\/c16\/23702964_1374654889218_270x202.jpg //车系图片",
"hasNewCar":true,//有新车上市
"cars": [
{
"id": "33318",
"minPrice": "23.10",
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/01/c0/14229062_14229062_1349107127921_120x90.jpg //车型图片",
"price": "27.28",
"status": "在售",
"title": "2015款 1.8 30TFSI 手动舒适型",
}
]
}],
"modelTotal": 86,//所有的车型总数
"pageCount": 18,
"pageNo": 1,
"pageSize": 1,
"total": 18
}
2.4.11 我要优惠
已上线。
请求url:http://mrobot.pcauto.com.cn/v3/price/getPromotionv45?serialId=631&dealerId=15626&modelId=26484&modelName=本田CR-V 2013款 2.0 两驱经典版&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1306/07/c17/21782908_1370599620432_350x260.jpg&areaId=1&areaName=广州
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
返缓存方式:
缓存时间:
说明:
线上接口:http://mrobot.pcauto.com.cn/v3/price/getPromotion?dealerId=15075&dealerName=%E5%B9%BF%E5%B7%9E%E9%94%A6%E9%BE%99%E5%A5%A5%E8%BF%AA&modelId=33313&modelName=%E5%A5%A5%E8%BF%AAA4L%202015%E6%AC%BE%202.0%2035TFSI%20%E8%87%AA%E5%8A%A8%E6%A0%87%E5%87%86%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/01/c0/14229062_14229062_1349107127921_350x260.jpg
请求后端url:
请求参数:
dealerId:经销商ID (必填)
dealerName:经销商名称 (可选 )
modelId:车型id (必填)
modelName:车型名称 (必填)
url:车型图片链接(必填)
serialId:车系id(必填)
areaId:城市ID(必填)
areaName:城市名称(必填)
阅读模式:无参数 白天;night 晚间
返回结果:
点击车型选择协议: pcaction://choose-car/json={"cars":[{"id":1, name:"车型名字"}]}
定义js函数:
setCar(modelId,modelName,url);调用效果:设置车型,modelId(车型id),modelName(车型名称),url(车型图片地址)
在HTML源码里,加入该经销商在售可选车型数据,格式参照:2.4.9 询底价页
我要报名接口:用之前的接口
url:http://dev3.pcauto.com.cn:8001/dealer/action/do_comm_order_2013.jsp
param:modelId 车型ID
dealerId 车系Id
regionId 城市
name 用户名称
phone 联系方式
origin数据来源,默认是3 ios ,4表示android
2.4.12 预约试驾
已上线。
请求url:http://mrobot.pcauto.com.cn/v3/price/testdriverv45/?areaId=0&modelId=33318&seq=0&modelName=%E5%A5%A5%E8%BF%AAA4L+2015%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c6/37300232_37300232_1407743541947_120x90.jpg&serialId=3524
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
返缓存方式:
缓存时间:
说明:
线上接口:http://mrobot.pcauto.com.cn/v3/price/testdriver/?areaId=0&modelId=33318&seq=0&modelName=%E5%A5%A5%E8%BF%AAA4L+2015%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c6/37300232_37300232_1407743541947_120x90.jpg
请求后端url:http://mrobot.pcauto.com.cn/v3/price/provinceCityList
请求参数:
serialId: 车系id (必填)
dealerId:经销商ID (必填)
dealerName:经销商名称 (可选)
modelId:车型id (必填)
modelName:车型名称(必填)
url:车型图片链接(必填)
阅读模式:无参数 白天;night 晚间
返回结果:
点击车型选择协议: pcaction://choose-car/json={"cars":[{"id":1, name:"车型名字"}]}
点击地址选择协议: pcaction://location/
定义三个js函数:
setlocation(regionId,regionName) ;调用效果:设置地址,regionId(城市id),regionName(城市名称)
setCar(modelId,modelName,url);调用效果:设置车型,modelId(车型id),modelName(车型名称),url(车型图片地址)
在HTML源码里,加入该经销商在售可选车型数据,格式参照:2.4.9 询底价页
2.4.13 车系-文章
备注:
请求URL:(获取某个车系下的文章列表)http://mrobot.pcauto.com.cn/v3/price/getNewestInfoListBySerialId/9010?pageNo=1&pageSize=20
(新闻文章列表) http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20
(评测文章列表)http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20
(导购文章列表)http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1小时
请求参数:
serialId:车系id
ageNo:页码
pageSize:每页行数
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/serialGroup_news.jsp?sid=9010
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=+serial_ids:3524%20AND%20-channel_id:000001743%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path
&highlight=false&returnType=json&clusterQuery=cluster_channel:%D0%C2%CE%C5%B6%AF%CC%AC%20OR%20cluster_channel:%D0%C2%B3%B5%D7%CA%D1%B6
&sort=time:desc&mustquery=y&pageNo=1&perPage=20
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false
&returnType=json&clusterQuery=cluster_channel:%c6%c0%b2%e2%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false
&returnType=json&clusterQuery=cluster_channel:%b5%bc%b9%ba%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20
请求后端参数:
serialId:车系id
pageNo:页码
perPage:每页行数
返回结果:
{
"data": [
{
"channel": "评测",
"commentNum": "141",
"downs": 234,
"id": "4810527",
"mustWatch": "0",
"pubDate": "2014-07-22",
"title": "JEEP全路况体验日 全方位领略越野魅力",
"ups": 403,
"image": "新增image",
"url": "http://www.pcauto.com.cn/pingce/481/4810527.html"
}
],
"pageCount": "1",
"pageNo": "1",
"pageSize": "9"
}
2.4.14 车型-综述
未上线,可连192.168.22.145测试
请求url:http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=modelIds=28350,32262
旧版本url:http://mrobot.pcauto.com.cn/v3/price/modelsv40/33533?areaId=1&isCompared=0&app=pcautobrowser&v=4.3.0
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
返缓存方式:无
缓存时间:无
说明:
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=27149
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp? //其他车型
http://mrobot.pcauto.com.cn/v3/price/allRegionList //地区
"http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId="+modelId+"&pageSize=25&pageNo=1&mapType=2areaId = 1"
请求参数:
modelId:车型id
areaId:地区id
modelIds:用于客户端重新刷新页面时保留原来的对比的状态,每个已加入对比的车型,车型ID放到这个字符串中用逗号分开
app:客户端调用协议,pcautobrowser
v:版本号,目前有两个可选值,分别为4.1.0、4.3.0
阅读模式:无参数 白天;night 晚间
提供函数setCompared(modelId,compare),去掉对比compare为0,加入对比compare为1
协议:
点击图片协议:pcaction://goto-pic/
点击去团购:pcautobrowser://activity/6254活动id
点击车型加入对比:pcaction://compare/?modelId=33876&modelName=xx
点击车型取消对比:pcaction://decompare/?modelId=33877&modelName=xx
点击进入经销商详情页:pcautobrowser://agents-detail/?dealerId=30716
点击进入地图:pcautobrowser://abc-map/?jing=113.36269383788195&wei=22.987620058096958&name=%E7%B2%A4%E6%A0%87%E4%B8%9C%E9%A3%8E%E6%82%A6%E8%BE%BE%E8%B5%B7%E4%BA%9A&address=%E5%B9%BF%E5%B7%9E%E7%95%AA%E7%A6%BA%E8%BF%8E%E5%AE%BE%E5%A4%A7%E9%81%93%E4%
B8%AD%E7%91%9E%E5%8D%8E%E6%B1%BD%E8%BD%A6%E5%9F%8E%E3%80%82%E4%B9%98%E8%BD%A6%E7%BA%BF%E8%B7%AF%3A1.%E5%AE%8F%E5%9F%8E%E5%B9%BF%E5%9C%BA%EF%BC%8D%E5%8D%8E%E5%8D%97%E7%A2%A7%E6%A1%82%E5%9B%AD%E5%85%8D%E8%B4%B9%E6%A5%BC%E5%B7%B4%E3%80%822.301%E3%80%81302%E5%85%AC%E4%BA%A4%E7%9B%B4%E8%BE%BE%E3%80%823.%E5%8D%8E%E5%8D%97%E5%BF%AB%E7%BA%BF20%E5%88%86%E9%92%9F%E8%BD%A6%E7%A8%8B%E6%88%96%E6%B4%9B%E6%BA%AA%E5%A4%A7%E6%A1%A5%EF%BC%8D%E8%BF%8E%E5%AE%BE%E8%B7%AF
eg:pcautobrowser://abc-map/?jing=113.36269383788195&wei=2
2.987620058096958&name=粤标东风悦达起亚&address=广州番禺迎宾大道中瑞华汽车城。乘车线路:1.宏城广场-华南碧桂园免费楼巴。2.301、302公交直达。3.华南快线20分钟车程或洛溪大桥-迎宾路
点击电话咨询:pcaction://webview_tel/电话号码(如400-860-0903)
点击询底价:pcautobrowser://auto-ask-price/?modelId=33876&modelName=%E8%B5%B7%E4%BA%9AK3+2015%E6%AC%BE+1.6+%E6%89%8B%E5%8A%A8GL&dealerId=15407&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1308%2F14%2Fc10%2F24479672_1376473605447_120x90.jpg
eg:pcautobrowser://auto-ask-price/?modelId=33876&modelName=起亚K3+2015款+1.6+手动GL&dealerId=15407&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/14/c10/24479672_1376473605447_120x90.jpg
在html源加入经销商的信息
/*@_HTML_META_START_
{"location":[{"dealerAddress":"广州市天河区黄埔大道东580号(地铁5号线东圃站A出口处)","dealerArea":"广州","dealerId":17125,"dealerImg":"http://www1.pcauto.com.cn/2010/price/img/chexi_hg.png","dealerName":"广州安骅雪佛兰 ","dealerPhone":"13928774756","dealerPhone400":"400-860-0876","dealerPrice":"13.69","hasPromote":"0","is4S":true,"jing":"113.40752068452792","lnglat":"113.40752068452792,23.115562785229184","mainBrand":" 上海通用雪佛兰 雪佛兰(进口)","modelType":"0","namelistRange":"0","priceRange":"","promotePrice":"","vip":2,"wei":"23.115562785229184"}]}
_HTML_META_END_@*/
返回结果:
2.4.14.1 车型-参配
未上线,代理192.168.22.145测试
请求url:http://mrobot.pcauto.com.cn/v3/price/detailv36/{modeId}?v=4.5
旧版本url:http://mrobot.pcauto.com.cn/v3/price/detailv36/33533
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
返缓存方式:无
缓存时间:无
说明:
请求参数:
v=4.5时去除上锚点定义的内容
fmt=json时只显示json数据
返回结果:
滚动到对应section时,触发协议: pcaction://show-section/${类型名}
2.4.14.2 车型-点评
请求url:http://mrobot.pcauto.com.cn/v3/price/commentListv45/${modeid} eg:26011
旧:http://mrobot.pcauto.com.cn/v3/price/commentDetail/33533?isShow=0
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
返缓存方式:
缓存时间:
说明:
请求参数:
modeid:车型ID
原始数据接口:http://dev3.pcauto.com.cn:8001/interface/iphone/detail_comment_owner.jsp?version=2 ,2表示4.5版本
返回结果:
{
"datas": [
{
"advantageScore": "1.4T+DSG 开起来动力充沛,有不是很费油,除了DSG有点揪心,别的无愧黄金组合的称号。",
"comfortScore": "5.0",
"comfortText": "还不错吧,在座椅高低调节,小长途不是很累,自己从某宝上买的坐垫还行,自己弄上大包围脚垫瞬间高大上。",
"configureScore": "4.0",
"configureText": "",
"consumption": "9.7",
"consumptionScore": "5.0",
"consumptionText": "市区10-12个,偏高,因为车多,红绿灯多,车开不快,走走停停的。高速长途5.5-6.6个,很省油。只要车比较匀速的跑上十几公里以上,就非常省油。",
"controlScore": "5.0",
"controlText": "操控还是不错,算是合格,和传统大众车型一致,方向盘增加了上下调节,方向盘也比较轻,排挡都一样,离合较轻,不是很重,赞一个,比曾经的老捷达和帕萨特轻不少!!也许是新车的原因!",
"createTime": "1407381060000",
"date": "201401",
"drawbackScore": "车内异响 朗逸车内的异响应该是通病了吧,由于前面的仪表台全是硬塑料的,时不时会传来阵阵异响。车门也同样如此,加速或者高速巡航的时候车门的共振声音非常明显。就连座椅有时候都会出现吱吱嘎嘎的声音。哎,把音乐打开直接忽略吧!",
"face": "34089619",
"flag": "0",
"formatCreateTime": "2个月前",
"interiorScore": "3.0",
"interiorText": "说到内饰,怎么说呢,全部是塑料,全车找不到一点软的地方(除顶棚、座椅),连后排上面那个台板居然也是塑料的,太坑了,值得表扬的是仪表中控布局不错,很耐看。再弱弱的问大众,手风为啥只有一个顶灯,后面的人怎么办?以前的那个桑塔纳2000后面还配了顶灯,无语吧。",
"maintainedText": "",
"name": "Mr暧魅",
"photos": [],
"powerScore": "5.0",
"powerText": "本人2012年4月购入2011款自动品雅版1.6L朗逸,总体来说动力还算过的去,平常开开还能应对自如,但是如果飙车,开快车的情况下,动力明显不够用。1、2档较肉并且无力。3、4档的时候稍微有些提速的感觉,但是我觉得已经可以了,毕竟朗逸这款车是针对家用车设计的,会选择买这款车的人,都不是为了飙车为目的买的。",
"price": "10.69",
"score": "4.63",
"spaceScore": "5.0",
"spaceText": "",
"surfaceScore": "5.0",
"surfaceText": "要说外观..这个是最稀饭了,那犀利的大灯,那流畅的腰线,那丰满的那啥...我选的简约银,个人感觉比黑色的显大,还有就是不那么容易脏(即使脏也不容看出来,吼吼,懒人是基本不洗车的...),改款以后朗逸的外观有了很大的改变,特别是车头,大众家族式的前脸让人过目不忘...也更加的富有活力,更让俺这样的90后小青年喜欢....",
"usefulCount": "0"
}
],
"metaUri": "http://dev3.pcauto.com.cn:8001/interface/iphone/detail_comment_owner.jsp?version=2&mid=26011",
"modelId": "26011",
"modelName": "朗逸 2013款 改款 1.6L 手动 风尚版",
"rankOil": "6.5",
"rankPrice": "10.99",
"rankScore": "3.63"
}
点击协议:
点击用户头像:pcautobrowser://user-center/?uid=用户的id
点击评论跳转:pcautobrowser://auto-comment/modelId=车型ID?pageNo=第几条评论&total=评论总条数&only=1
图片跳转协议:pcautobrowser://comment-photo/?modelName=车型名称&modelId=车型Id&start=第几张评论图片&pictures=[{"bigPath":大图路径,"smallPath:小图路径},{"bigPath":大图路径,"smallPath:小图路径}]
2.4.15 车型库-根据厂商id出该厂商的所有车系
请求url:http://mrobot.pcauto.com.cn/v3/price/getSerialListByManufacturerId/33?v=4.5.0
HTTP请求方式:GET
是否需要登录:false
返回格式:json
返缓存方式:无
缓存时间:无
说明:
请求参数:
/33 厂商id
v=4.5.0
返回结果:
{
"manufacturers": [
{
"brandName": "大众",
"name": "大众(进口)",
"brandIntroduction": "http://price.pcauto.com.cn/qcbk/ppgs/VW/1208/2068884.html",
"serials": [
{
"id": 2383,
"name": "途锐",
"kind": "中大型SUV",
"priceRange": "68.6~136.48 万",
"isNew": 0,
"sellStatus": 3,
"carVersion": 1,
"carField": 2,
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_2383.jpg",
"count": 35
},
...
]
}
]
}
2.5.0 离线下载包
请求url:
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:对象缓存
缓存时间:5分钟
说明:
请求参数:
targetId:
返回结果:
是一个zip包,其中是首页接口前30条的具体包内容,有文章,帖子,图集
2.5.1 修改昵称
请求url:http://my.pcauto.com.cn/intf/syncNickName.jsp
HTTP请求方式:POST
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:增加参数,可修改性别
请求参数:
req_enc:UTF-8
resp_enc:UTF-8
nickName:昵称
act:save
sex:性别
common_session_id:登录后的session,Cookies传值
返回结果:
{"code":0}表示成功, {"code":非0,"message":"提示"}
2.5.2 违章查询
请求url:http://cha.wcar.net.cn/taipingyang
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:无
缓存时间:
说明:
请求参数:
返回结果:
2.5.3 常见问题
请求url:
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:
请求参数:
返回结果:
点击详细问题,进入常见问题终端页协议:pcautobrowser://FAQ/10003
2.5.3.1 常见问题终端
请求url:
HTTP请求方式:GET
是否需要登录:false
返回格式:HTML页面
缓存方式:接口缓存
缓存时间:60分钟
说明:
请求参数:
id:常见问题id
返回结果:
2.5.4 返回包括关注的好友和粉丝
请求url:http://my.pcauto.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:GET
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:增加相互关注标示,共同关注标示
请求参数:
accountId:用户ID,如果没有改参数的话则返回当前用户的好友列表
act:findFocus为关注,findFocusBy为粉丝
pageNo:页码
pageSize:页长度
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
common_session_id:登录后的session,Cookies传值
返回结果:
{
"total": 1,
"pageNo": 1,
"resultList": [
{
"fanNum": 3,
"accountId": 30768965,
"focusNum": 2,
"nickName": "摇号最讨厌了",
"image": "http://i1.3conline.com/images/upload/upc/face/30/76/89/65/30768965_50x50",
"mutualFocus":相互关注true,否则false
"commonFocus":共同关注true,否则false
}
],
"pageCount": 1,
"pageSize": 20
}
2.5.5 我的收藏-经销商
请求url:
HTTP请求方式:GET
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:
请求参数:
dealerid:经销商id
common_session_id:登录后的session,Cookies传值
返回结果:
2.5.5.1 经销商收藏
请求url:
HTTP请求方式:POST
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:
请求参数:
dealerid:经销商id
common_session_id:登录后的session,Cookies传值
返回结果:
2.5.5.2 删除经销商收藏
请求url:
HTTP请求方式:POST
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:
请求参数:
dealerid:经销商id
common_session_id:登录后的session,Cookies传值
返回结果:
2.5.5.3 文章收藏相关
请求url:http://bip.pcauto.com.cn/intf/article.jsp
HTTP请求方式:POST
是否需要登录:true
返回格式:JSON
缓存方式:无
缓存时间:
说明:
请求参数:
act :isCollect是否已经收藏该文章,getMyCollection获取自己收藏的文章,delMyCollection取消收藏
callback :支持回调函数,=windowname时表示以windowname形式返回
windowname :1或true 以windowname形式返回,不传或0或false以json格式返回
articleId :文章ID
siteId :站点ID(文章属于哪个网站)(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
pageNo :页号(不传默认为1)
pageSize :每页显示多少条数据(不传默认为20,最小值为1,最大值为100)
返回结果:
-------------
{"code":-1,"message":"登录后才能操作!"}
{"code":1,"message":"该文章已被该用户收藏"}
{"code":2,"message":"该文章未被该用户收藏"}
-------------
{"code":-1,"message":"登录后才能操作!"}
-------------
{"code":0,"message":"删除收藏文章成功!"}
{"code":-1,"message":"删除收藏文章失败!"}
如果未登录:
{"code":-1,"message":"登录后才能操作!"}
2.6.0 降价列表
请求url:
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
缓存方式:接口缓存
缓存时间:60分钟
说明:
原有接口: http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=popularity
增加一个筛选方式,类似精准选车的
请求参数:
areaId:地区id
brandId:品牌id
serialId:车系id
modelId:车型id
orderBy:popularity, newest, discountRange, lowestPrice;
分别指按车型热度,按最新,按降价幅度,按最低价格
返回结果:
{
"data": [
{
"area": "广州",
"createTime": 1406602096000,
"dealerId": "45742",
"dealerName": "进口大众广州鸿众",
"dealerNewsId": "5154551",
"dealerType": "综合店",
"decline": "35.0",
"discount": "163400",
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/01/c8/24016521_1375350331166_350x260.jpg",
"is400": "1",
"isShow24Icon": 1,
"modelId": "32583",
"modelName": "高尔夫(进口) 2014款 2.0 TSI R敞篷版",
"modelPrice": "46.68",
"phone": "400-860-0819",
"price": "30.34",
"serialGroupId": 4391,
"serialGroupName": "高尔夫(进口)"
}
],
"pageNo": 1,
"pageSize": 20,
"total": 6559
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)