[[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请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: serialIds=1,2,3 车系id,以逗号间隔 返回结果:说明,除了第1中情况程序出错返回的响应状态为500,其他情况经返回200 1.正常返回: { "code": 0, "total": 5, "list": [ { ////资讯格式 "channelId": 2, "channelName": "新车", "count": 3, "downs": 13, "id": "4721075", "image": "http://img0.pcauto.com.cn/pcauto/1407/02/g_4688183_1404269779131_240x160.jpg", "title": "2014款帅客正式上市 售6.48-9.18万元", "type": 1, "ups": 13, "url": "http://www.pcauto.com.cn/nation/472/4721075.html", "type": 3(1为属于资讯,2为论坛,3为购车优惠), "date": "2014-5-13 星期二" }, { ////论坛格式 "count": 14, "downs": 39, "forumName": "", "id": "5037151", "image": "http://img0.pcauto.com.cn/pcauto/1407/07/4715883_1.jpg", "preView": "[今日话题]一撞就起火 特斯拉值那个价吗?", "seq": 4, "title": "[今日话题]一撞就起火 特斯拉值那个价吗?", "to-uri": "pcautobrowser://bbs-topic/5037151", "type": 2, "updateAt": 1404662400000, "ups": 13, "type": 2(1为属于资讯,2为论坛,3为购车优惠), "date": "2014-5-13 星期二" }, { //购车优惠格式 "id": 2, "userId": 24286812, "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万", "lowerPrice": "", "city": "", "shopType": "4S店", "company": "出厂名", "type": 3(1为属于资讯,2为论坛,3为购车优惠), "date": "2014-5-13 星期二", } ] } }}} === 2.2 [=#point202 文章终端]=== {{{ 备注:获取文章 请求URL:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=3.6.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 HTTP请求方式:get 是否需要登录:否 返回格式:html页面 缓存方式:无 缓存时间:1小时 请求参数: 文章ID articleTemplate=3.6.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版本增加协议: 添加订阅: pcaction://addSubscribe/id?serialName=xxx&price=xxx&image=xxx pcautobrowser://serial/id }}} === 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://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请求方式:get 是否需要登录:否 返回格式:HTML页面 缓存方式:无 缓存时间:无 请求参数: sid:车系id night:有此参数为夜间模式,否则为日间模式 点击对比按钮,跳转协议 pcaction://hot-pk/?id1=xx&id2=xx&name1=xxx&name2=xxx }}} === 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 请求后端URL: http://ks.pcauto.com.cn/search.jsp?q=state:1&returnType=json&appName=auto_price&perPage=0 &clustered=cluster_price,cluster_brand,cluster_std_displacement,cluster_kind,cluster_gearbox 4.4版本修改: 返回结果增加,显示更多的条件 }}} === 2.6 [=#point206 视频分类]=== {{{ 备注:视频分类 请求URL: HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: 返回参数: { types:[ { id:1, name:原创视频 }, { id:2, name:新车视频 }, { id:3, name:娱乐百态 } ] } }}} === 2.6.1 [=#point2061 价格范围]=== {{{ 备注:价格范围 请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_guide_price_range HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数:无 返回参数: { "data": [ { "id": 28, "name": "10万<=" }, { "id": 29, "name": "10-15万" }, { "id": 30, "name": "15-20万" }, { "id": 31, "name": "20-30万" }, { "id": 74, "name": "30-50万" }, { "id": 33, "name": ">=50万" } ] } }}} === 2.6.2 [=#point2062 用车宝典]=== {{{ 备注:用车宝典 请求URL: HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: 返回参数: { sections:[ { id:1, name:驾驶技巧 sections:[ { id:4 name:恶劣天气驾驶技巧 sections:[ { id:4 name:下雪怎么开车 } } ] } ] } }}} === 2.6.3 [=#point2063 新车上市]=== {{{ 备注:新车上市 请求URL: HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: 返回参数: { "coming": { id name } "recently": { id name } } }}} === 2.7 [=#point207 资讯栏目]=== {{{ 备注:资讯栏目 请求URL:http://mrobot.pcauto.com.cn/v2/cms/channels/1 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:5分钟 请求参数: 栏目ID 省份pro和城市city // 当栏目id为55555时该参数有效 4.4版本修改: 新增“游记”栏目(ID 000048723) 和 “赛事”栏目(000058522),位置放在“用车”后面 }}} === 2.7.1 [=#point2071 视频栏目列表]=== {{{ 备注:视频栏目列表 请求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.2 [=#point2072 导购栏目列表]=== {{{ 备注:导购栏目列表 请求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.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请求方式:get 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间: 请求参数: date:日期2014-09 返回结果: { "modelId": 424,//该车系第一个车型 "modelName": “宝马3系”,//该车系第一个车型 "serialId": 354, "serialName": "马自达6", "price": "28.3-66.2万", "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/05/c0/28324073_1383616337906_270x202.jpg", "type":1新车,2改款 } }}} === 2.8 [=#point208 判断文章是否已经收藏]=== {{{ 备注:判断文章是否已经收藏 请求URL: HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id aid:文章id 返回参数:如果已经登陆并且已经收藏,返回收藏id,否则返回-1 }}} === 2.8.1 [=#point2081 判断车系是否已经收藏]=== {{{ 备注:判断车系是否已经收藏 请求URL: HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id sid:车系id 返回参数:如果已经登陆并且已经收藏,返回收藏id,否则返回-1 }}} === 2.8.2 [=#point2082 判断车型是否已经收藏]=== {{{ 备注:判断车型是否已经收藏 请求URL: HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id mid:车型id 返回参数:如果已经登陆并且已经收藏,返回收藏id,否则返回-1 }}} === 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/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.10.1 [=#point210 添加收藏的文章]=== {{{ 备注:添加收藏的文章 请求URL:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=addFavorarticle HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id favorArticleId:文章id,如果要批量添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx }}} === 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://my.pcauto.com.cn/intf/FavorArticle.jsp?act=delFavorarticle HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id favorArticleId:文章id,如果要删除添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx }}} === 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:每页显示多少条 }}}