[[TOC]] == 1.基本约定 == {{{ 接口通用参数 req_enc=utf-8(必须放url后面) resp_enc=utf-8(必须放url后面) common_session_id=xxxx(以cookies中的优先) 接口URL: 接口URL 必填参数:参数名=xxx(多种情况用括号解析) 非必填参数:参数名=xxx(多种情况用括号解析) 说明文档参数:添加某特定参数可以直接看接口文档 是否需要登录:是,否 返回格式:json,ssi,xml 缓存方式:接口缓存,对象缓存 缓存时间:缓存时间 返回结果:结果可能情况 }}} == 2.接口列表 == === 2.1 [=#point201 小编精选推荐](已上线)=== {{{ 备注:此接口返回若干个小编精选推荐车系,客户端自动筛选4个用以显示 请求url:http://mrobot.pcauto.com.cn/configs/pcauto_editor_picked_recommend HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 说明:ads为广告,list为常规数据 { "ads": [ { "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/13/c9/24440713_1376387144385_270x202.jpg", "serialId": 354, "serialName": "马自达6", "price": "12.98-15.98万" } ], "list": [ { "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/24/c16/23702964_1374654889218_270x202.jpg", "serialId": 3404, "serialName": "福克斯", "price": "9.98-16.99万" }, { "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/16/c13/23389440_1373956410390_270x202.jpg", "serialId": 9306, "serialName": "马自达CX-5", "price": "16.98-25.28万" }, { "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1202/28/c3/10633808_10633808_1330395935562_270x202.jpg", "serialId": 3344, "serialName": "劳恩斯", "price": "39.8-58.8万" } ] } }}} === 2.1.1 [=#point2011 最新内容](已上线)=== {{{ 请求url:http://mrobot.pcauto.com.cn/v2/cms/subscribeNews?pageNo=1&pageSize=20&areaId=1&ids1=3404,3225,1633&ids2=3404,3225,1633&ids3=3404,3225,1633 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:有 缓存时间:4小时 请求参数: pageNo:第几页; pageSize:每页显示的条数; areaId:地区id; ids1:要订阅资讯的车系id; ids2:要订阅帖子的车系id; ids3:要订阅降价优惠的车系id; 注意:对ids1、ids2、ids3的具体使用说明如下: 如果某个用户订阅了3款车,分别为3404(福克斯)、3225(朗逸)、1633(速腾),他希望这3款车都能看到资讯、帖子、降价优惠,那么ids1=3404,3225,1633、ids2=3404,3225,1633、ids3=3404,3225,1633; 如果他希望3404(福克斯)这款车订阅资讯、帖子、降价优惠,3225(朗逸)这款车订阅资讯、帖子,1633(速腾)这款车只订阅降价优惠,那么ids1=3404,3225、ids2=3404,3225、ids3=3404,1633; { "data": [ { "date": 1406773251000, "date2": "2014-07-31 星期四", "id": "4870625", "image": "http://img0.pcauto.com.cn/pcauto/1407/31/g_4870625_1406772976092_240x160.jpg", "serialName": "朗逸", "title": "上海大众朗逸购车优惠0.5万元 赠送送礼", "type": 1 //文章 }, { "date": 1406767932000, "date2": "2014-07-31 星期四", "id": "5125285", "image": "http://imgm.pconline.com.cn/images/upload/upc/tx/bbs6/1407/31/c0/36889009_1406767531175_240x160.jpg", "serialName": "昂克赛拉", "title": "终于到手~昂克赛拉2.0 运动白两厢提车~~求射 !", "type": 2 //帖子 }, { "date": 1406718282000, "date2": "2014-07-30 星期三", "id": "5167599", //行情id "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1301/16/c1/17443560_1358303901828_350x260.jpg", "modelId": "24436", //车型id,请注意,跳转到降价优惠详情页的时候是需要行情id和车型id的 "serialName": "捷达", "title": "捷达 2013款 1.6 自动豪华型 降1.0万", "type": 3 //降价优惠 } ], "pageNo": 1, "pageSize": 3, "total": 150 } }}} === 2.2 [=#point202 文章终端](已上线)=== {{{ 备注:获取文章 请求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 是否需要登录:否 返回格式:html页面 缓存方式:有 缓存时间:1小时 请求参数: 文章ID articleTemplate=4.4.0 size:字体大小 app=pcautobrowser picRule:请求网络方式:0 非wifi; 2 wifi访问 pageNo:页码 template:模板 channelId:栏目ID serialId:车系ID date:文章直播时间(说明:当参数template=live时,传递date,否则不传) 阅读模式:无参数 白天;night 晚间 请求后端URL: helper_uri_articles_3?id=4147040 请求后端参数: id:4147040(从id_0取出) 4.4版本增加协议: 添加订阅(添加订阅接口:http://trac.pc.com.cn/iphone/wiki/pcauto_4.3.0/interface#a2.17增加订阅已上线): pcaction://addSubscribe/serialId?serialName=xxx&price=xxx&image=xxx 删除订阅(删除订阅接口:http://trac.pc.com.cn/iphone/wiki/pcauto_4.3.0/interface#a2.18删除订阅已上线): pcaction://deleteSubscribe/serialId pcautobrowser://serial/serialId 说明:在文章页底部,用户对订阅和退订是可以相互切换的,即按钮的状态会改变的,在此客户端需通过调用函数setSubscribed来改变按钮状态。 按钮状态设置为“订阅”使用setSubscribed(0),设置为“退订”使用setSubscribed(1); }}} === 2.3 [=#point203 获取图片评论接口]=== {{{ 备注:获取图片评论接口 请求URL:http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: topicId:主题ID articleId:文章ID reverse:排序方式:0 倒序; 1 正序 pageNo:页码 pageSize:每页行数 pic:是否图片评论:0或者不填否,1是 请求后端URL: http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13118127&arch=0&reverse=0&pageSize=20 http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13118127 请求后端参数: tid:主题ID(从id_0取出) reverse:排序方式:0 倒序; 1 正序 pageSize:每页行数 返回参数: { "comments": [ { "1": { "client": "1", "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684", "floor": "113", "id": "27265992", "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB", "time": "2014-07-08 09:50:03", "userId": "0" }, "current": "1", "expand": false, "support": "0" }, { "1": { "client": "1", "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684", "floor": "112", "id": "27265870", "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB", "time": "2014-07-08 09:37:55", "userId": "0" }, "current": "1", "expand": false, "support": "0" } ], "pageCount": 6, "pageNo": 1 } }}} === 2.3.1 [=#point2031 获取图集最新评论楼层数]=== {{{ 备注:获取图集最新评论楼层数,图集的原url构成方法:http://beauty.pcauto.com.cn/photolist/${id}.html id为new_topics接口取得的id 请求URL:http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://beauty.pcauto.com.cn/photolist/${id}.html HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: url:图集url 请求后端URL: http://cmt.pcauto.com.cn/action/topic/get_data.jsp?url=http://beauty.pcauto.com.cn/photolist/${id}.html 请求后端参数: url:图集url }}} === 2.3.2 [=#point2032 回复评论]=== {{{ 备注:回复评论 请求URL:http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp HTTP请求方式:post 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: topicId:主题ID topicUrl:主题url articleTitle:文章标题 content:回复内容 name:用户名 是否匿名:0 否 replyFloor:回复楼层 articleId:文章ID }}} === 2.4 [=#point204 热门对比](已上线)=== {{{ 备注:热门对比 请求URL:http://mrobot.pcauto.com.cn/v3/price/hotModelCompare/{modelId} HTTP请求方式:get 是否需要登录:否 返回格式:HTML页面 缓存方式:无 缓存时间:无 请求参数: modelId:车型id night:有此参数为夜间模式,否则为日间模式 点击对比按钮,跳转协议 pcaction://hot-pk/?id1=xx&id2=xx }}} === 2.5 [=#point205 精准选车条件](已上线)=== {{{ 备注:精准选车条件 请求URL: v4.3之前使用此接口:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0 v4.3之后使用此接口:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.3.0 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:7天 请求参数: v:版本号,v有两个可选值,分别为4.0.0、4.3.0 }}} === 2.5.1 [=#point2051 精准选车结果](已上线)=== {{{ 接口URL: 获取选车结果: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 获取选车结果总数:http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&fmt=total&v=4.3.0 请求参数:price:价格; jb:级别; pl:排量; bsx:变速箱; bid:品牌,支持多选,如bid=2,10表示选中大众和丰田多个品牌; country:国别; mkid:车身结构; qdfs:驱动方式; jq:进气方式; carf:产地; rl:燃料; zw:座位数; isCz:是否车载; pz:配置,支持多选,如pz=3_5表示选中车身稳定控制和GPS导航; ps:自定义最低价; pe:自定义最高价; pageNo:页数; pageSize:每页显示的条数; v:版本别,此处v=4.3.0; fmt:获取选车结果总数,fmt=total 说明:价格、级别、排量、变速箱等参数的值使用[2.5 精准选车条件]中对应条件下value字段的值 提交方式:GET 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 }}} === 2.6 [=#point206 视频分类](已上线)=== {{{ 备注:视频分类 请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_video_subchannels HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { "data": [ { "id": 131, "name": "原创视频" }, { "id": 132, "name": "新车视频" }, { "id": 133, "name": "娱乐百态" }, { "id": 134, "name": "广告欣赏" }, { "id": 135, "name": "试车视频" }, { "id": 136, "name": "技术视频" }, { "id": 137, "name": "资讯视频" }, { "id": 138, "name": "车展视频" } ] } }}} === 2.6.1 [=#point2061 价格范围](已上线)=== {{{ 备注:价格范围 请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_guide_price_range HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { "data": [ { "id": 28, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_0_10.png", "name": "10万<=" }, { "id": 29, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_10_15.png", "name": "10-15万" }, { "id": 30, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_15_20.png", "name": "15-20万" }, { "id": 31, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_20_30.png", "name": "20-30万" }, { "id": 74, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_30_50.png", "name": "30-50万" }, { "id": 33, "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_50_up.png", "name": ">=50万" } ] } }}} === 2.6.2 [=#point2062 用车宝典](已上线)=== {{{ 备注:用车宝典 请求URL:http://mrobot.pcauto.com.cn/v2/cms/yongchebaodian HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: 返回参数: { "sections":[ { "name":"驾驶技巧", "image":"http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_car_guider_1.png", "sections":[ { "name":"恶劣天气驾驶技巧" "sections":[ { "id":123,//文章id "name":"下雪怎么开车" } } ] } ] } }}} === 2.6.3 [=#point2063 新车上市](已上线)=== {{{ 备注:新车上市 请求URL:http://mrobot.pcauto.com.cn/v3/price/upcomingSerials HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:有 缓存时间:15分钟 请求参数:无 { "data": [ { "flag": "即将发布", "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3565.jpg", "serialGroupId": 3565, "serialGroupName": "奥德赛" }, { "flag": "新车上市", "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_10801.jpg", "serialGroupId": 10801, "serialGroupName": "雷凌" } ] } }}} === 2.7 [=#point207 资讯栏目] (可内测)=== {{{ 备注:资讯栏目 请求URL:http://mrobot.pcauto.com.cn/v2/cms/channels/15?pageNo=1&pageSize=20&v=4.0.0 (游记) http://mrobot.pcauto.com.cn/v2/cms/channels/16?pageNo=1&pageSize=20&v=4.0.0 (赛事) HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:30分钟 请求参数: 栏目ID pageNo:页数 pageSize:每页显示多少条 4.4版本修改: 新增“游记”栏目(ID 000048723) 和 “赛事”栏目(000058522),位置放在“用车”后面 }}} === 2.7.1 [=#point2071 视频栏目列表] (已上线)=== {{{ 备注:视频栏目列表 请求URL:http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:30分钟 请求参数: id:栏目id,从此处请求获取http://mrobot.pcauto.com.cn/configs/pcauto_video_subchannels pageSize:没有显示多少条 pageNo:第几页 v:版本号,此处v=4.0.0 返回结果: { "data": [ { "count": 0, "downs": 221, "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/22/4277983_nx200tc.jpg", "id": "4277983", "image": "http://img0.pcauto.com.cn/pcauto/1404/22/g_4277983_1398157978271_240x160.jpg", "pubDate": "2014-04-22", "title": "剑指Q3和X1!雷克萨斯NX200T解析", "ups": 1339, "url": "http://www.pcauto.com.cn/client/427/4277983.html" }, { "count": 0, "downs": 182, "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4268521_4267124_im77_thumbcc.jpg", "id": "4268521", "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4268521_1398060573979_240x160.jpg", "pubDate": "2014-04-21", "title": "宝马X6缩小版?宝马X4详细实拍解析", "ups": 338, "url": "http://www.pcauto.com.cn/client/426/4268521.html" }, { "count": 0, "downs": 143, "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4269767_13979940933982940_600cc.jpg", "id": "4269767", "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4269767_1398066907717_240x160.jpg", "pubDate": "2014-04-21", "title": "奔驰最新的设计语言 奔驰C-Class L解析", "ups": 572, "url": "http://www.pcauto.com.cn/client/426/4269767.html" }, { "count": 0, "downs": 1937, "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4267539_H2OK.jpg", "id": "4267539", "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4267539_1398053758876_240x160.jpg", "pubDate": "2014-04-21", "title": "售10.58万元!哈弗H2详细实拍解析", "ups": 676, "url": "http://www.pcauto.com.cn/client/426/4267539.html" }, { "count": 0, "downs": 507, "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4270100_4263520_2_thumbcc.jpg", "id": "4270100", "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4270100_1398068597789_240x160.jpg", "pubDate": "2014-04-21", "title": "丰富的配置!比亚迪全新SUV S7解析", "ups": 1976, "url": "http://www.pcauto.com.cn/client/427/4270100.html" } ], "pageNo": 1, "pageSize": 5, "total": 22 } }}} === 2.7.2 [=#point2072 导购栏目列表] (已上线)=== {{{ 备注:导购栏目列表 请求URL:http://mrobot.pcauto.com.cn/v2/cms/getArticlesByTagId/{tagId}?pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:15分钟 请求参数: tagId:价格区间对应的id,从接口http://mrobot.pcauto.com.cn/configs/pcauto_guide_price_range中获取 pageNo:页数 pageSize:每页显示多少条 返回结果: { "data": [ { "count": 308, "id": "3438040", "image": "http://img0.pcauto.com.cn/pcauto/1311/19/g_3438040_1384850430733_240x160.jpg", "pubDate": "2013-11-19", "title": "不输途观价格更优 斯柯达野帝购车手册", "url": "http://www.pcauto.com.cn/teach/343/3438040.html" }, { "count": 248, "id": "3441059", "image": "http://img0.pcauto.com.cn/pcauto/1311/19/g_3441059_1384863321944_240x160.jpg", "pubDate": "2013-11-19", "title": "1.8L车型竞争力足 北京现代名图购车手册", "url": "http://www.pcauto.com.cn/teach/344/3441059.html" }, { "count": 332, "id": "3331703", "image": "http://img0.pcauto.com.cn/pcauto/1311/03/g_3331703_1383475180321_240x160.jpg", "pubDate": "2013-11-04", "title": "以运动之名 15-20万元入门级小钢炮推荐", "url": "http://www.pcauto.com.cn/teach/333/3331703.html" }, { "count": 295, "id": "3303979", "image": "http://img0.pcauto.com.cn/pcauto/1310/28/g_3303979_1382972638878_240x160.jpg", "pubDate": "2013-10-31", "title": "激情又顾家 20万元级运动款中级车推荐", "url": "http://www.pcauto.com.cn/teach/330/3303979.html" }, { "count": 337, "id": "3273724", "image": "http://img0.pcauto.com.cn/pcauto/1310/26/g_3273724_1382756431874_240x160.jpg", "pubDate": "2013-10-27", "title": "18万高性价比选择 舒适好开中级车推荐", "url": "http://www.pcauto.com.cn/teach/327/3273724.html" } ], "pageCount": 9, "pageNo": 1, "pageSize": 5, "total": 43 } }}} === 2.7.3 [=#point2073 ~~用车栏目列表~~]=== {{{ 备注:用车栏目列表 请求URL: HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: tid:类型id 返回结果: { "articleList": [ { "id": "4254001", "pubDate": "2014-04-18", "title": "What is My Car? 最适合的才最好", "url": "http://www.pcauto.com.cn/news/425/4254001.html" }, { "id": "3683314", "pubDate": "2013-12-31", "title": "戴姆勒Car2Share驾临鹏城 腾讯乐享创新出行", "url": "http://www.pcauto.com.cn/news/368/3683314.html" } ], "curPage": 1, "perPage": 100, "start": 1, "statistic": { "cluster_channel": [ "新闻动态_41" ] }, "time": 0, "total": 41 } }}} === 2.7.4 [=#point2074 新车栏目列表](已上线)=== {{{ 备注:新车栏目列表 请求URL:http://mrobot.pcauto.com.cn/v3/price/getSerialsByDate?year=2014&month=7&pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:有 缓存时间:15分钟 请求参数: year:年份; month:月份; pageNo:第几页; pageSzie:每页显示多少条 返回结果: { "data": [ { "date": "07月28日", "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_10801.jpg", "price": "10.78-15.98万", "serialGroupId": 10801, "serialGroupName": "雷凌", "type": "新车" }, { "date": "07月28日", "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3986.jpg", "price": "3.68-4.58万", "serialGroupId": 3986, "serialGroupName": "悦悦", "type": "改款" }, { "date": "07月28日", "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8179.jpg", "price": "7.99-11.69万", "serialGroupId": 8179, "serialGroupName": "昕锐", "type": "改款" } ], "pageCount": 16, "pageNo": 1, "pageSize": 3, "total": 47 } }}} === 2.8 [=#point208 判断文章是否已经收藏]=== {{{ 备注:判断文章是否已经收藏 请求URL:http://bip.pcauto.com.cn/intf/article.jsp?act=isCollect&siteId=2&articleId=4868899 HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id articleId:文章id }}} === 2.8.1 [=#point2081 判断车系是否已经收藏]=== {{{ 备注:判断车系是否已经收藏 请求URL:http://my.pcauto.com.cn/intf/isCarCollect.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id seriesId:车系id 返回参数: {"code":-2,"message":"用户没登陆"} {"code":-1,"message":"缺少参数"} {"code":0,"message":"已收藏"} {"code"1,"message":"没有收藏该车型"} {"code":2,"message":"没有收藏该车系"} }}} === 2.8.2 [=#point2082 判断车型是否已经收藏]=== {{{ 备注:判断车型是否已经收藏 请求URL:http://my.pcauto.com.cn/intf/isCarCollect.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id modelId:车型id 返回参数: {"code":-2,"message":"用户没登陆"} {"code":-1,"message":"缺少参数"} {"code":0,"message":"已收藏"} {"code"1,"message":"没有收藏该车型"} {"code":2,"message":"没有收藏该车系"} }}} === 2.9 [=#point209 手机号注册]=== {{{ 备注:手机号注册 条件:(开发和测试环境都可以开通例外) 1.必须post提交; 请求URL:http://passport2.pconline.com.cn/passport2/api/registerForMobile.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: req_enc 提交编码 resp_enc 返回编码 mobile 手机号码 captcha 手机验证码 username 用户名 password 密码 passwordConfirm 确认密码 返回参数: {"status":2,"desc":"message","field":"mobile"} status = 0 注册成功; status = -2 注册时发生未预期错误,请与管理员联系! 其他 field:出错位置 desc:错误信息 }}} === 2.9.1 [=#point2091 发送手机验证码]=== {{{ 备注:发送手机验证码 1.必须post提交; 2.指定页面提交方可调用接口(需要申请); 3.同一ip一分钟之内可以发一次; 4.同一ip一天之内只能发5次(目前的设定); 5.同一个手机号码一天之内只能发5次(目前的设定); 请求URL:http://passport2.pconline.com.cn/passport2/api/sendVerificationCode.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: 设置referer为mobileRegister.jsp act = getPassword 不检查手机号码是否已经注册 act = check 必须传 verificationCode = (验证码),检查验证码是否正确。 不传act 参数,将会默认检查手机是否注册,已注册手机不发验证码。 mobile= 手机号 callback= 支持回调函数 (以下两个参数为必填,为了防刷而添加的,vCodeKey为通过特定的MD5加密,VCodeTime为系统当前时间) vCodeKey = sendVerificationCode.jsp+当前系统毫秒数 进行md5加密 VCodeTime = 为系统当前时间毫秒数 //取系统当前时间再和指定key做md5加密 String Vkey = "sendVerificationCode.jsp"; long VCodeTime =System.currentTimeMillis(); String vCodeKey = T.md5(Vkey + VCodeTime); request.setAttribute("VCodeTime", VCodeTime); request.setAttribute("vCodeKey", vCodeKey); //end匹配加密信息 返回参数: {"code":-1, "message":"...各种情况.."} {"code":0, "message":"发送验证码成功,手机号:1111111"} }}} === 2.9.2 [=#point2092 邮箱注册]=== {{{ 备注:邮箱注册 请求URL:http://passport2.pconline.com.cn/passport2/api/register.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: req_enc 提交编码 resp_enc 返回编码 captcha :验证码 username 用户名 password 密码 passwordConfirm 确认密码 email :邮箱地址 return :返回地址(URL) 返回参数: {"status":2,"desc":" + message + ","field":"mobile"} "accountId":123456, "emailHome":"http://mail.XXX.com", "returnUrl":"http://XXX.pcXXXXX.com.cn/login.jsp", "codeNumber":"M3KS5F6" status = 0 注册成功; status = -2 注册时发生未预期错误,请与管理员联系! 其他 field:出错位置 desc:错误信息 }}} === 2.9.3 [=#point2093 验证用户名]=== {{{ 备注:验证用户名 请求URL:http://passport2.pconline.com.cn/passport2/api/validate_account.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: username 用户名 recommendNum :用户名被占用产生多少随机用户名(默认3个) 返回参数: {"status":2,"desc":" + message + ","field":"mobile"} status : 处理状态(0 为成功,其他为失败) desc : 处理状态描述 }}} === 2.9.4 [=#point2094 验证手机号]=== {{{ 备注:验证手机号 请求URL:http://passport2.pconline.com.cn/passport2/api/validate_mobile.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: mobile 手机号 返回参数: {"status":2,"desc":" + message + ","field":"mobile"} status : 处理状态(0 为成功,其他为失败) desc : 处理状态描述 }}} === 2.9.5 [=#point2095 验证邮箱]=== {{{ 备注:验证邮箱 请求URL:http://passport2.pconline.com.cn/passport2/api/validate_email.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: email :邮箱地址 返回参数: {"status":2,"desc":" + message + ","field":"mobile"} status : 处理状态(0 为成功,其他为失败) desc : 处理状态描述 }}} === 2.9.6 [=#point2096 获取验证码图片]=== {{{ 备注:验证码接口, 请求URL:http://captcha.pcauto.com.cn/captcha/v.jpg HTTP请求方式:get 是否需要登录:否 返回格式: 缓存方式:禁用缓存 缓存时间:无 请求参数:无 返回参数: 返回一张验证码图片 }}} === 2.9.7 [=#point2097 发激活邮件]=== {{{ 备注:发激活邮件(必须登录),在邮箱注册成功并且登录之后调用;另,发帖/回帖失败后发现是因为未激活邮箱,则调用此接口 请求URL:http://passport2.pconline.com.cn/passport2/api/send_activate_email.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: returnUrl: 找回密码邮件返回跳转Url 返回参数: {"status":0,"desc":"OK","email":"xxx@xxx.com","emailHome":"http://mail.XXX.com","codeNumber":"M3KS5F6"} {"status":-1,"desc":"登录后才能发激活邮件"} {"status":2,"desc":"您的帐号已经激活"} {"status":1,"desc":"该邮箱已经注册过,请修改邮箱后再发激活信"} {"status":3,"desc":"发送邮件出错"} status : 处理状态(0 为成功,其他为失败) desc : 处理状态描述 email: 邮箱地址 emailHome : 电子邮箱登陆页面 codeNumber :(用户发送邮件到服务邮箱)激活邮箱所需验证码 field : 定位到表单输入框(状态为失败时才出现) }}} === 2.10.1 [=#point210 添加收藏的文章]=== {{{ 备注:添加收藏的文章 请求URL:http://bip.pcauto.com.cn/intf/article.jsp?act=addArtCollect&siteId=2 HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id articleId:文章id,不支持批量 }}} === 2.10.2 [=#point2102 添加收藏的车型]=== {{{ 备注:添加收藏的车型,说明:此接口不支持批量添加 请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id series:车系id model:车型id }}} === 2.10.3 [=#point2103 添加收藏的帖子]=== {{{ 备注:添加收藏的帖子 请求URL:http://bbs.pcauto.com.cn/action/user/favorite.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id tid:帖子id }}} === 2.10.4 [=#point2104 删除收藏的文章]=== {{{ 备注:删除收藏的文章 请求URL:http://bip.pcauto.com.cn/intf/article.jsp?act=delMyCollection&siteId=2 HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id articleId:文章id,不支持批量 }}} === 2.10.5 [=#point2105 删除收藏的车型]=== {{{ 备注:添加删除的车型,说明:此接口不支持批量删除 请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id carId:爱车id }}} === 2.10.6 [=#point2106 删除收藏的帖子]=== {{{ 备注:删除收藏的帖子 请求URL:http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id tid:帖子id,如果一次性要删除收藏的多条帖子,请拼接多个id参数,即:id=xxx&id=xxx }}} === 2.10.7 [=#point2107 判断版块、帖子是否已经收藏]=== {{{ 备注:判断版块、帖子是否已经收藏 请求URL:http://bbs.pcauto.com.cn/action/user/check_favorite.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id fid:版块id tid:帖子id 返回参数:如果已经登陆并且版块或者帖子已经收藏,返回收藏id,否则返回-1 }}} === 2.10.8 [=#point2109 收藏夹信息---文章]=== {{{ 备注:判断版块、帖子是否已经收藏 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles?pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 请求后端URL: http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=getFavorarticle&pageNo= 1&pageSize=20 请求后端参数: act:getFavorarticle pageNo:页数 pageSize:每页显示多少条 }}} === 2.10.10 [=#point21010 收藏夹信息---车型]=== {{{ 备注:收藏夹信息---车型 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=0&pageNo=1&pageSize=20 HTTP请求方式:GET 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id type:类型,此处为0 pageNo:页数 pageSize:每页显示多少条 请求后端URL: http://my.pcauto.com.cn/intf/getCars.jsp?act=getCarModels&pageNo=1&pageSize=20 请求后端参数: act:getCarModels pageNo:页数 pageSize:每页显示多少条 }}} === 2.10.11 [=#point21011 收藏夹信息---帖子]=== {{{ 备注:收藏夹信息---帖子 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id 用户id pageNo:页数 pageSize:每页显示多少条 请求后端URL: http://bbs.pcauto.com.cn/intf/user/_favTopics.jsp?userId=826717&pageSize=20&pageNo=1 请求后端参数: userId:826717(从id_0取出) pageNo:页数 pageSize:每页显示多少条 }}} === 2.11.0 [=#point2110 上传图片]=== {{{ 备注:上传图片 请求URL:http://upc.pcauto.com.cn/upload_quick.jsp?application=bbs6&command=1&command=31000&command=31001&command=31002&command=31003&keepSrc=yes HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id keepSrc:yes保留原始文件,no不保留原始文件,如果不指定则不保留。 command: 处理指令id,可以多个,顺序执行 application:应用名称,此项不能为空。帖子上传图片,使用bbs6 返回参数: 失败:{retCode: xxx} 成功: {retCode: 0,tid:xxx,files:[ {rid:xxx, fileName:xxx, url:xxx, orgFileName:xxx, width, height}, ... , ]} }}}