[[TOC]] == 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 [=#point2.1.1 资讯首页] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:false 返回格式:json 缓存方式:接口缓存 缓存时间:5分钟 请求参数: channelId:栏目id 说明: 返回结果中type说明 0其他 1文章 2帖子 3图集 4直播 5专题 6活动 7新专题-上面一个专题名,下面是展示3篇文章 8新图集-展示图集名和三张小图 返回结果: { "data": [ { "channelId": 2, "channelName": "新车", "count": 10, "downs": 0, "ups": 13, "id": "5023924", "image": "http://img0.pcauto.com.cn/pcauto/1408/26/g_5023924_1409017503587_240x160.jpg", "pubDate": "2014-08-26", "title": "2014广州车展专题", "articles": [ { "channelId": 2, "channelName": "新车", "count": 10, "downs": 0, "id": "5023924", "image": "http://img0.pcauto.com.cn/pcauto/1408/26/g_5023924_1409017503587_240x160.jpg", "pubDate": "2014-08-26", "title": "野马F16将成都车展上市 并发布全新LOGO", "type": 1, "ups": 13, "url": "http://www.pcauto.com.cn/nation/502/5023924.html" } ], "type": 7, "url": "http://www.pcauto.com.cn/nation/502/5023924.html" }, { "count": 22, "downs": 0, "id": "10003", "pubDate": "2014-08-26", "seq": 8, "title": "奔跑的哲学家 2014年奥迪R8 V8图赏", "photos": [ { "desc": "据《每日邮报》报道,玻利维亚的北杨格思公路(North Yungus Road)被称为“死亡之路”,它位于海拔15400英尺(约4693米)的高山上,每年能夺走约300人的生命。", "id": 144959, "name": "最危险的公路之一 玻利维亚“死亡之路”", "thumb": "http://i4.3conline.com/images/piclib/201408/22/batch/1/240546/1408680049464joxx56dlfl_small.jpg" } ], "to-uri": "pcautobrowser://album-photo/10003", "type": 3, "updateAt": 1408982400000, "ups": 0 } ], "topFocus": [ { "cc-uri": "", "image": "http://imgad0.pcauto.com.cn/ivy/image/20148/25/14089529815230.jpg", "seq": 4, "title": "广告", "to-uri": "http://ivy.pcauto.com.cn/adpuba/click?adid=331803&id=auto.khd.zx.jdt4.", "updateAt": 1409021941845, "vc-uri": "http://ivy.pcauto.com.cn/adpuba/show?adid=331803&id=auto.khd.zx.jdt4.&media=js" } ], "total": 150 } }}} === 2.1.2 [=#point2.1.2 文章页终端] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=4.4.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 增加一段JS,addComments(jsonArray),调用效果: 当有数据时以jsonArray中前两条(有可能是一条)评论显示为热门评论部分 当数据为空时,不显示热门评论部分 }}} === 2.1.2.1 [=#point2.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 [=#point2.1.3 地区选择] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 缓存方式:接口缓存 缓存时间:7天 请求参数: 说明: 原有接口: http://mrobot.pcauto.com.cn/v2/cms/area_tree 返回结果: { "hot": [ { "id": 1, "name": "广东", "cities": [ ["1","广州","5401","广州市"], ["4","深圳","5401","深圳市"] ] } ] } }}} === 2.2.0 [=#point2.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 [=#point2.2.0 论坛首页-猜你喜欢] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:true 返回格式:json 缓存方式:接口缓存 缓存时间:60分钟 请求参数: common_session_id:登录后的session,Cookies传值 说明: 返回结果: { "topics": [ { "authorId": 22393072, "authorName": "hkitty", "authorPhoto": "http://i1.3conline.com/images/upload/upc/face/22/39/30/72/22393072_50x50", "contribution": 0, "forumId": 19017, "forumName": "内部测试", "images": [ { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611290_1406089561207.jpg", "width": 100, "height": 200 }, { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611294_1406089563340.jpg", "width": 100, "height": 200 }, { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611296_1406089565044.jpg", "width": 100, "height": 200 } ], "postCount": 1, "pubTime": 1406166953000, "topicId": 5098712, "topicTitle": "又来啦早晨" } ] } }}} === 2.2.1 [=#point2.2.1 帖子列表] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/bbs/newForums/16856?pageNo=1&pageSize=19&orderby=replyat HTTP请求方式:GET 是否需要登录:false 返回格式:json 缓存方式:无 缓存时间: 说明:4.5版本增加一个提问帖,最多显示三张图,默认显示2条置顶帖,多出的列表隐藏起来,通过点击可以展开和收起,展开后最多只能5条。置顶帖的显示上,要和普通的帖子在样式和结构上有所不同 出精华帖和提问帖时,不需要出指定帖 请求参数: id:论坛ID或者车系id idType:表示该url上的id类型,如果是serial为车系id,如果是forum则为论坛id pageNo:页码 pageSize:一页条数 orderby=postat:最新帖,orderby=replyat:最热帖 type: 1全部帖子,2精华帖,3提问帖 返回结果: { "tops": { "title": "置顶消息", "topics": [ { "authorId": 22393072, "authorName": "hkitty", "authorPhoto": "http://i1.3conline.com/images/upload/upc/face/22/39/30/72/22393072_50x50", "forumId": 19017, "forumName": "内部测试", "images": [ { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611290_1406089561207.jpg", "width": 100, "height": 200 }, { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611294_1406089563340.jpg", "width": 100, "height": 200 }, { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611296_1406089565044.jpg", "width": 100, "height": 200 } ], "postCount": 1, "pubTime": 1406166953000, "topicId": 5098712, "topicTitle": "又来啦早晨" } ] }, "topics": [ { "authorId": 22393072, "authorName": "hkitty", "authorPhoto": "http://i1.3conline.com/images/upload/upc/face/22/39/30/72/22393072_50x50", "contribution": 0, "forumId": 19017, "forumName": "内部测试", "images": [ { "url": "http://imgrt.pconline.com.cn/images/upload/upc/tx/bbs6/1407/23/c0/spcgroup/bbs/center/36611290_1406089561207.jpg", "width": 100, "height": 200 } ], "postCount": 1, "pubTime": 1406166953000, "topicId": 5098712, "topicTitle": "普通帖子", "answerCount":12提问帖中回答的人数,非提问帖可以不用这个 } ], "pageNo": 1, "pageSize": 20, "total": 10 } }}} === 2.2.2 [=#point2.2.2 帖子终端] === {{{ 请求url:http://mrobot.pcauto.com.cn/v2/bbs/topics/5217852?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 HTTP请求方式:GET 是否需要登录:true 返回格式: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 }}} === 2.2.3 [=#point2.2.3 删帖] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:json 缓存方式:无 缓存时间: 说明: 请求参数: common_session_id:登录后的session,Cookies传值 topicid:帖子id 返回结果: }}} === 2.2.4 [=#point2.2.4 加精] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:json 缓存方式:无 缓存时间: 说明: 请求参数: common_session_id:登录后的session,Cookies传值 topicid:帖子id 返回结果: }}} === 2.2.5 [=#point2.2.5 评分] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:json 缓存方式:无 缓存时间: 说明: 请求参数: common_session_id:登录后的session,Cookies传值 topicId:帖子id score:分数 返回结果: }}} === 2.2.5.1 [=#point2.2.5.1 获取用于分数] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:json 缓存方式:无 缓存时间: 说明: 用于获取用户的分数 请求参数: common_session_id:登录后的session,Cookies传值 返回结果: }}} === 2.2.6 [=#point2.2.6 精华设置] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:json 缓存方式:无 缓存时间: 说明: 用于取设置精华的选项 请求参数: 返回结果: }}} === 2.3.0 [=#point2.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 [=#point2.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 [=#point2.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) 返回结果: { "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 [=#point2.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 [=#point2.4.0 车型库首页] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/1 原地址:http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid={brandId}&type={type} HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 缓存方式:接口缓存 缓存时间:1分钟 说明:增加status,用于区分在售分类 请求参数: 返回结果: { "manufacturers": [ { "brandIntroduction": "http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html", "brandName": "奥迪", "name": "一汽奥迪", "serials": [ { "count": 41, "id": 3524, "isNew": 0, "kind": "中型车", "name": "奥迪A4L", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg", "priceRange": "27.28~57.81 万", "sellType":1, "status": "在售" } ] } ] } }}} === 2.4.0.1 [=#point2.4.0.1 热销排行] === {{{ 请求url: 原地址: HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 缓存方式:接口缓存 缓存时间:1分钟 说明:新增 请求参数: 返回结果: { "section": [ { "type": "小型车", "serials": [ { "count": 41, "id": 3524, "isNew": 0, "kind": "中型车", "name": "奥迪A4L", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg", "priceRange": "27.28~57.81 万", "sellType":1, "status": "在售" } ] } ] } }}} === 2.4.1 [=#point2.4.1 车系综述页] === {{{ 请求url: 原地址:http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId={serialId} HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:1分钟 说明: 原有接口:http://mrobot.pcauto.com.cn/v3/price/serialv40/7929?v=4.3.0 新增图片、点评、团购、经销商、购车计算等入口 请求参数: 返回结果: 点击图片协议: pcaction://goto-pic/id?index=第几张图 点击点评协议: pcaction://goto-comment/ 点击团购协议: pcautobrowser://goto-group-buying/ 点击经销商协议: pcaction://goto-dealer/dealerid 点击询底价: pcautobrowser://serial-ask-price/?serialId=33318&serialName=2015%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&dealerId=&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1210%2F01%2Fc0%2F14229062_14229062_1349107127921_120x90.jpg 点击购车计算: pcautobrowser://calculate-cost/modelid }}} === 2.4.2 [=#point2.4.2 车系参配页] === {{{ 请求url: 原地址: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 样式调整、滚动时增加协议 请求参数: 返回结果: 滚动到对应section时,触发协议: pcaction://show-section/${类型名} 提供一个js函数gotoSection(index),调用后跳转到对应的锚点 源代码中,加入 /*@_HTML_META_START_ {"types":[{"anchor":"锚点名字","name":"类型名"}]} _HTML_META_END_@*/ }}} === 2.4.3 [=#point2.4.3 车系优惠页] === {{{ 请求url: 原地址:http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?serialId=7889&pageSize=25&pageNo=1&mapType=2&dealerType=1&areaId=1 HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 说明: 原有接口:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=7889&areaId=1 请求参数: serialId=7889车系id areaId=1地区id 返回结果: }}} === 2.4.4 [=#point2.4.4 车系点评页] === {{{ 请求url: 原地址:http://price.pcauto.com.cn/interface/iphone/detail_comments_by_sgid.jsp?sid=7929&pageNo=1&pageSize=10 HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:15分钟 说明: 样式调整,区分在售、停售 原有接口:http://mrobot.pcauto.com.cn/v3/price/commentList/7929 请求参数: 返回结果: }}} === 2.4.5 [=#point2.4.5 车系车型图片筛选条件] === {{{ 请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0 原地址:http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp?serialId={serialId}&modelId={modelId} HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 缓存方式:接口缓存 缓存时间:60分钟 说明:types增加字段section,用于细化外观 请求参数: 返回结果: { "colors": [ { "id": "14270", "name": "檀木黑" } ], "models": [ { "id": "22608", "name": "2013款 1.8 自动Premium" } ], "types": [ { "id": "1", "name": "外观", "section": [ { "id": "1", "name": "全部" }, { "id": "1", "name": "车头" } ] } ] } }}} === 2.4.6 [=#point2.4.6 车系\车型图片] === {{{ 请求url:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=7889&pageSize=1497&typeId=1&colorId=0&modelId=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 colorId // 颜色id 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.7 [=#point2.4.7 车系经销商] === {{{ 请求url: 原地址: //#start 获取车系中的第一款车型 http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=${serialId}; //#start 地区 http://mrobot.pcauto.com.cn/v3/price/allRegionList //#start 经销商 http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 说明: 线上接口:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=7929&areaId=1 新增 请求参数: 返回结果: 在HTML源码里,加入全部经销商的数据json,包括地址&百度地图坐标 /*@_HTML_META_START_ {"dealer":[{}]} _HTML_META_END_@*/ }}} 点击经销商地图协议: pcautobrowser://dealer-map/?all }}} === 2.4.7.1 [=#point2.4.7.1 经销商(车系)详情] === {{{ 请求url: 原地址: http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?serialId=7889&pageSize=20&pageNo=1&mapType=2&areaId=1 http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp?pageSize=3&pageNo=1&dealerId=15407 http://price.pcauto.com.cn/dealer/interface/app/dealer_serialgroup_json.jsp?pageSize=12&pageNo=1&dealerId=15407 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 和4.4版本的经销商详情不一样:此版本经销商详情只能从车系页进入,预约试驾,询底价功能都是针对车系的 请求参数: 返回结果: 点击预约试驾协议: pcautobrowser://pcauto-appoint4driving/?serialId=21803&serialName=%E5%A5%A5%E8%BF%AAA4L+2013%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&dealerId=65469&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1408%2F11%2Fc6%2F37300232_37300232_1407743541947_120x90.jpg 点击询底价协议: pcautobrowser://auto-ask-price/?serialId=21803&serialName=%E5%A5%A5%E8%BF%AAA4L+2013%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&dealerId=65469&url=http%3A%2F%2Fimg.pconline.com.cn%2Fimages%2Fupload%2Fupc%2Ftx%2Fauto5%2F1408%2F11%2Fc6%2F37300232_37300232_1407743541947_120x90.jpg }}} === 2.4.8 [=#point2.4.8 公司介绍] === {{{ 请求url: 原地址: HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 说明:新增 请求参数: 返回结果: }}} === 2.4.9 [=#point2.4.9 询底价页] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/price/askprice?dealerId=49712&dealerName=%E5%B9%BF%E5%B7%9E%E6%96%87%E5%8D%8E%E7%A6%8F%E7%91%9E%E7%A6%8F%E7%89%B9+&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请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:无 缓存时间: 说明: 请求参数: dealerId dealerName modelId modelName url:车型图片链接 阅读模式:无参数 白天;night 晚间 返回结果: 点击车型选择协议: pcaction://choose-car/{"cars":["id":1,"name":"车型名字"]} 点击地址选择协议: pcaction://location/ 在HTML源码里,加入可选车型 /*@_HTML_META_START_ {"cars":[{"count":4,"id":9550,"isNew":0,"kind":"紧凑型车","name":"奥迪A3","photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg","priceRange":"19.99~28.67 万"}]} _HTML_META_END_@*/ }}} === 2.4.10 [=#point2.4.10 精准选车条件结果] === {{{ 请求url: 原地址: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要改成可多选 请求参数: 返回结果: { "serial": { "id": 573618, "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", "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 手动舒适型", "vendorPrice": "23.10~27.28" } ] }, "modelTotal": 86, "pageCount": 18, "pageNo": 1, "pageSize": 1, "total": 18 } }}} === 2.4.11 [=#point2.4.11 我要优惠] === {{{ 请求url: 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 原始接口: 我要报名接口:http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8 请求参数: modelId:车型id carBrandId: 品牌id carSerialId: 车系id userName:姓名 phone:手机号 dealerId:经销商id regionId:城市id, provinceId:省份id, tsgId:活动id origin:平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志 isInitMsg: 没有活动id时该值为1,有活动id时为0 返回结果: 200:请求成功 204:请求参数不完整 205:活动已结束 206:活动未审核 207:活动审核失败 }}} === 2.4.12 [=#point2.4.12 预约试驾] === {{{ 请求url: 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 请求参数: dealerId dealerName modelId modelName url:车型图片链接 阅读模式:无参数 白天;night 晚间 返回结果: 在HTML源码里,加入可选车型 /*@_HTML_META_START_ {"cars":[{"count":4,"id":9550,"isNew":0,"kind":"紧凑型车","name":"奥迪A3","photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg","priceRange":"19.99~28.67 万"}]} _HTML_META_END_@*/ }}} === 2.4.13 [=#point2.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 [=#point2.4.14 车型-综述] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/price/modelsv40/33533?areaId=1&isCompared=0&app=pcautobrowser&v=4.3.0 HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 返缓存方式: 缓存时间: 说明: 请求后端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 isCompared:车型id存在为1;不存在为0 app:客户端调用协议,pcautobrowser v:版本号,目前有两个可选值,分别为4.1.0、4.3.0 阅读模式:无参数 白天;night 晚间 返回结果: }}} === 2.4.14.1 [=#point2.4.14.1 车型-参配] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/price/detailv36/33533 HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 返缓存方式: 缓存时间: 说明: 请求参数: 返回结果: }}} === 2.4.14.2 [=#point2.4.14.2 车型-点评] === {{{ 请求url:http://mrobot.pcauto.com.cn/v3/price/commentDetail/33533?isShow=0 HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 返缓存方式: 缓存时间: 说明: 请求参数: 返回结果: }}} === 2.5.0 [=#point2.5.0 离线下载包] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:false 返回格式:JSON 缓存方式:对象缓存 缓存时间:5分钟 说明: 请求参数: targetId: 返回结果: 是一个zip包,其中是首页接口前30条的具体包内容,有文章,帖子,图集 }}} === 2.5.1 [=#point2.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 [=#point2.5.2 违章查询] === {{{ 请求url:http://cha.wcar.net.cn/taipingyang HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:无 缓存时间: 说明: 请求参数: 返回结果: }}} === 2.5.3 [=#point2.5.3 常见问题] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 说明: 请求参数: 返回结果: 点击详细问题,进入常见问题终端页协议:pcautobrowser://FAQ/10003 }}} === 2.5.3.1 [=#point2.5.3.1 常见问题终端] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:false 返回格式:HTML页面 缓存方式:接口缓存 缓存时间:60分钟 说明: 请求参数: id:常见问题id 返回结果: }}} === 2.5.4 [=#point2.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 } ], "pageCount": 1, "pageSize": 20 } }}} === 2.5.5 [=#point2.5.5 我的收藏-经销商] === {{{ 请求url: HTTP请求方式:GET 是否需要登录:true 返回格式:JSON 缓存方式:无 缓存时间: 说明: 请求参数: dealerid:经销商id common_session_id:登录后的session,Cookies传值 返回结果: }}} === 2.5.5.1 [=#point2.5.5.1 经销商收藏] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:JSON 缓存方式:无 缓存时间: 说明: 请求参数: dealerid:经销商id common_session_id:登录后的session,Cookies传值 返回结果: }}} === 2.5.5.2 [=#point2.5.5.2 删除经销商收藏] === {{{ 请求url: HTTP请求方式:POST 是否需要登录:true 返回格式:JSON 缓存方式:无 缓存时间: 说明: 请求参数: dealerid:经销商id common_session_id:登录后的session,Cookies传值 返回结果: }}} === 2.6.0 [=#point2.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 } }}}