[[TOC]] == 1.基本约定 == {{{ 1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 { "uri" : "/intf/albums-by-type.jsp", "error-desc":"Need you follow uid.", "user-notice":"给用户的提示放在这里" } 3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: String queryString = request.getQueryString(); String requestEncoding = getParam(queryString,"req_enc"); String responseEncoding = getParam(queryString,"resp_enc"); if(isNotBlank(requestEncoding)){ request.setCharacterEncoding(requestEncoding); } if(isNotBlank(responseEncoding)){ response.setCharacterEncoding(responseEncoding); } 4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。 6.需要登录的接口,cache-control=600 ;分开优先级低和主动请求两种,前者用cacheFirst,后者用noCache }}} == 2.接口列表 == === 2.1 [=#point201 左侧主菜单]=== {{{ url:madmin 配置项:http://mrobot.pcauto.com.cn/configs/pcauto_left_menu 作用:左侧主菜单 使用范围:汽车网app HTTP请求方式:get 是否需要登录:否 请求参数:none 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye/page.html 返回参数: [ { "id":1, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"首页", "view":"information-home/", "url":"http://www.baidu.com" }, { "id":2, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"降价", "view":"more/", "url":"http://www.baidu.com" }, { "id":3, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"找车", "view":"brand-list/", "url":"" }, { "id":4, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"论坛", "view":"bbs-home/", "url":"" }, { "id":5, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"行情", "view":"more/", "url":"http://www.baidu.com" }, { "id":6, "img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg", "title":"图集", "view":"album-list/", "url":"" } ] }}} === 2.2 [=#point202 默认订阅栏目]=== {{{ url:madmin 配置项:http://mrobot.pcauto.com.cn/configs/pcauto_home_default_subscription_channels 作用:获取默认订阅的栏目 使用范围:汽车网app HTTP请求方式:get 是否需要登录:否 请求参数:none 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html 返回参数: { "serialList": [ { "serialId": 22479, "name": "昂科拉ENCORE"//车系名称 }, { "serialId": 23395, "name": "大众Polo" } ] } }}} === 2.3 [=#point203 头条]=== {{{ url:http://mrobot.pcauto.com.cn/v2/cms/channels/1?serialIds=8670,4313,4457,3524&pageNo=1 作用:获取头条数据, 使用范围:汽车网app HTTP请求方式:get 是否需要登录:否 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html 请求参数: pageNo:页数 pageSize:每页显示的条数 serialIds:已经订阅的车系id,逗号分割 返回参数: "pageNo":1, "pageSize":20, "total":300, //栏目内容总数,最多300条 "data": [ { "count": 93, // 如果是文章则为评论数,如果是帖子则为楼层数,如果是图集则为图片张数 "id": "2965125", // 文章、帖子或者图集id "type":1, // 类型,1为文章,2为帖子,3为图集 "image": "", //导读图 "title": "", //内容标题 "channelName":"所属栏目", //如果是文章存在此字段,所属栏目,指3.6.0 mrobot整理的栏目 "channelId":123, //对应channelName的id "forumName":"版块名称", //如果是帖子存在此字段, 所属版块 "forumId":123, //对应论坛的id,帖子外的类型不存在这个字段 "ups":123, // 赞的数量 "downs":123 // 踩的数量 "pubDate":"2013-10-28" //发布日期 }, ... ], "focus":[], //照旧 topData:[ { floorCount: 0, image: "http://img0.pcauto.com.cn/pcauto/client/news/lubianshe/1306/000000000000000000_2.jpg", preView: "奔腾顶破护栏迎头撞上丰田 两司机全受伤", pubDate: "2013-03-20", seq: 1, title: "奔腾顶破护栏迎头撞上丰田 两司机全受伤", to-uri: "pcautobrowser://bbs-topic/3842343", updateAt: 1370620800000, downs: 0, //踩数 ups: 0, //顶数 "channelName":"所属栏目", //如果是文章存在此字段,所属栏目,指3.6.0 mrobot整理的栏目 "channelId":123, //对应channelName的id,文章外的类型不存在这个字段 "forumId":123, //对应论坛的id,帖子外的类型不存在这个字段 }], topFocus:[] //照旧 }}} === 2.3.1 [=#point2031 车系聚合页]=== {{{ url:http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/8670(已经订阅的车系id) 作用:获取车系聚合页数据 使用范围:汽车网app HTTP请求方式:get 是否需要登录:否 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html 请求参数: 已经订阅的车系id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo":1, "pageSize":20, "total":150, // 栏目内容总数,最多150条 "data": [ { "count": 93, //如果是文章则为评论数,如果是帖子则为楼层数 "id": "2965125", //文章、帖子 "type":1, //类型,1为文章;2为帖子 "image": "", //导读图 "title": "", //内容标题 "channelName":"所属栏目", //如果是文章存在此字段,所属栏目,指3.6.0mrobot整理的栏目 "channelId":123, //对应channelName的id,文章外的类型不存在这个字段 "forumName":"论坛版块", //如果是帖子存在此字段,所属版块 "forumId":123, //对应论坛的id,帖子外的类型不存在这个字段 "ups":12, //赞的数量 "downs":23 //踩的数量 pubDate: "2012-03-28" //发布日期 } ] } }}} === 2.4 [=#point204 赞和踩]=== {{{ url: http://mdata.pcauto.com.cn/pcauto/user/ups-downs.jsp 作用:对某个对象赞或者踩 使用范围:汽车网app 备注:该接口需要防止刷数据,间隔60秒 HTTP请求方式:post 是否需要登录:否 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html 请求参数: "id": 112(文章、帖子或者图集id), "action": 3 (动作,1为‘顶’、2为‘踩’、3为‘取消顶’、4为‘取消踩’), "type": 1( 类型id,1为文章、2为帖子或者3为图集) 返回参数: { "id":123 // 文章、帖子或者图集id "type":1, // 类型id,1为文章、2为帖子,3为图集 "resultCode":0, // 0表示成功,-1表示失败 "msg":"提示信息", // 提示信息 "ups":123, // 赞的数量 "downs":123 // 踩的数量 } 备注:参数错误以及非post方法提交会返回400的status code }}} === 2.5 [=#point205 搜索栏目文章]=== {{{ url:http://mrobot.pcauto.com.cn/v2/cms/channels/2?serialIds=3524 作用:点击文章终端的栏目按钮,出该车系的栏目文章 使用范围:汽车网app 备注:添加serialIds,在原来的基础上过滤出属于该车系的文章 HTTP请求方式:get 是否需要登录:否 请求参数: 栏目id serialIds:车系id,可选参数 返回参数: 参考3.6.0的栏目接口 http://mrobot.pcauto.com.cn/v2/cms/channels/2 }}} === 2.6 [=#point206 新消息]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount 作用:获取个人中心的新消息的数量 使用范围:汽车网app 备注:提醒包含一下几种 1.我发的帖子,别人回帖 2.我发的回帖,别人回复 3.我发的文章评论,别人回复 HTTP请求方式:get 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id 返回参数: messageCount:短消息(站内信、私信) systemNoticeCount:系统消息(例如删帖提示、设置精华提示等等) fansCount:关注消息 forumReplyCount:论坛消息(包括别人对我发的帖子的回帖和别人对我的回帖的回复) commentReplyCount:文章评论消息 carReplyCount:车主点品消息 提醒 = forumReplyCount + commentReplyCount }}} === 2.7 [=#point207 您可能对以下内容感兴趣]=== {{{ url: madmin配置项:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials,与[2.38 车型库首页热门车系列表]相同 作用:获取可能感兴趣内容 使用范围:汽车网app 备注:madmin配置项 设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye/page.html HTTP请求方式:get 是否需要登录:否 请求参数: 返回参数: { "manufacturers": [ { "name": "热门车系", "serials": [ { "id": 9550, "name": "奥迪A3", "kind": "紧凑型车", "priceRange": "null", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg", "count": 0 }, { "id": 8670, "name": "奥迪Q3", "kind": "中型SUV", "priceRange": "28.5~42.88 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8670.jpg", "count": 6 }, { "id": 4313, "name": "奥迪A6L", "kind": "中大型车", "priceRange": "38.3~74.26 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4313.jpg", "count": 59 }, { "id": 4457, "name": "奥迪Q5", "kind": "中大型SUV", "priceRange": "35.85~56.77 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4457.jpg", "count": 20 }, { "id": 3524, "name": "奥迪A4L", "kind": "中型车", "priceRange": "27.28~57.81 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg", "count": 32 } ] } ] } }}} === 2.8 [=#point208 收藏夹信息---文章]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles?pageNo=1&pageSize=20 作用:收藏夹信息---文章 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo": 1, "pageSize": 20, "total": 300, "articleList": [ { "id": 2965125, //文章id "image": "http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg",//导读图 "title": "[直播]成都车展探馆:奥迪RS5 Coupe亮相",//标题 "channelName": "导购",//所属栏目 "cmtCount": 57, "ups": 123,//赞的数量 "downs": 123//踩的数量 }, { "id": 3229359, "image": "http://img0.pcauto.com.cn/pcauto/1310/16/g_3229359_1381886137401_240x160.jpg", "title": "2014款长安CX20正式上市 售5.59-6.49万", "channelName": "新车", "cmtCount": 57, "ups": 12, "downs": 13 } ] } }}} === 2.9 [=#point209 收藏夹信息---帖子]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20 作用:收藏夹信息---帖子 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html 请求参数: common_session_id:用户登陆后获得的认证id 用户id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo": 1, "pageSize": 20, "total": 300, "topicList": [ { "id": 82360,//收藏id "topicId": 3811550,//帖子id "name": "首保时,4S给换的机油如何??", "ups": 12, "downs": 13, "forumName": "飞度论坛", "image":"http://img0.pcauto.com.cn/pcauto/1310/16/g_3229359_1381886137401_240x160.jpg", "replyCount":123 }, { "id": 81758, "topicId": 2536517, "name": "【活动报道】全新奥迪A8L上市品鉴会", "ups": 12, "downs": 13, "forumName": "奥迪A8L论坛", "image":"http://img0.pcauto.com.cn/pcauto/1310/16/g_3229359_1381886137401_240x160.jpg", replyCount":123 } ] } }}} === 2.10 [=#point210 收藏夹信息---车型]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=0&pageNo=1&pageSize=20 作用:收藏夹信息---车型 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html 请求参数: common_session_id:用户登陆后获得的认证id type:类型,此处为0 pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageCount": 1, "pageNo": 1, "pageSize": 20, "resultList": [ { "id": 263360,//爱车id "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1306/19/c7/22273734_1371613382296_270x202.jpg", "modelId": 21803, "modelName": "奥迪A4L 2013款 1.8 30TFSI 手动舒适型", "price": "23.09 - 27.54万", "serialId": 3524, "serialName": "奥迪A4L" }, { "id": 263361, "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/07/c9/12753707_12753707_1344329185828_270x202.jpg", "modelId": 21804, "modelName": "奥迪A4L 2013款 1.8 30TFSI 自动舒适型", "price": "24.64 - 29.36万", "serialId": 3524, "serialName": "奥迪A4L" } ], "total": 2 } }}} === 2.11 [=#point211 添加收藏]=== {{{ 1.添加收藏的帖子 url:http://bbs.pcauto.com.cn/action/user/favorite.jsp 请求参数: common_session_id:用户登陆后获得的认证id tid:帖子id 说明:此接口不支持批量添加 2.添加收藏的车型 url:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save 请求参数: common_session_id:用户登陆后获得的认证id series:车系id model:车型id 说明:此接口不支持批量添加 3.添加收藏的文章: url:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=addFavorarticle 请求参数: common_session_id:用户登陆后获得的认证id favorArticleId:文章id,如果要批量删除,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html }}} === 2.12 [=#point212 删除收藏]=== {{{ 1.删除收藏的帖子: url:http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp 请求参数: common_session_id:用户登陆后获得的认证id id:收藏id,为【2.9 收藏夹信息---帖子】接口中的id字段的值,如果一次性要删除收藏的多条帖子,请拼接多个id参数,即:id=xxx&id=xxx 2.删除收藏的车型: url:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar common_session_id:用户登陆后获得的认证id carId:爱车id,为【2.10 收藏夹信息---车型】接口中的id字段的值 说明:不支持批量删除 3.删除收藏的文章: url:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=delFavorarticle 请求参数: common_session_id:用户登陆后获得的认证id favorArticleId:文章id,如果要批量删除,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html }}} === 2.13 [=#point213 获取我的订阅]=== {{{ url:http:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=1&pageNo=1&pageSize=20 作用:我的订阅 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_Subscribe.html 请求参数: common_session_id:用户登陆后获得的认证id type:类型,此处为1 pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageCount": 1, "pageNo": 1, "pageSize": 20, "resultList": [ { "id": 263300, "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1303/14/c9/18905309_1363245848921_270x202.jpg", "price": "0", "serialId": 106, "serialName": "别克GL8" }, { "id": 263299, "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1303/14/c11/18906243_1363247136103_270x202.jpg", "price": "0", "serialId": 7891, "serialName": "昂科拉ENCORE" } ], "total": 2 } }}} === 2.14 [=#point214 增加订阅]=== {{{ url:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save 作用:增加订阅 使用范围:汽车网app HTTP请求方式:post 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_dy.html 请求参数: common_session_id:用户登陆后获得的认证id series,车系id 说明:不支持批量添加 返回参数: { "message": "保存数据成功", "carId": 263364,//爱车 "carPic": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/09/c11/23126695_1373352238390_270x202.jpg", "code": 1 } }}} === 2.15 [=#point215 删除订阅]=== {{{ url:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar 作用:删除订阅 使用范围:汽车网app HTTP请求方式:post 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_Subscribe.html 请求参数: common_session_id:用户登陆后获得的认证id carId:爱车id,为【2.13 获取我的订阅】中的id字段的值 说明:不支持批量删除 返回参数: { code: 1, message: "删除数据成功" } }}} === 2.16 [=#point216 获取提醒内容]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getReminds?pageSize=20&pageNo=1 作用:我的消息---提醒 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo":1, "pageSize":20, "total":200, "resultList": [ { "id": 123123, //根据type不同而不同,为1时这是帖子id,为2时这是文章id "type": 1,//1回复帖子,2回复评论 "face": "", "userName": "xxx", "userId": 6546, "createAt": 1382582506000, "toReply": "引用内容", "content": "回复内容", "topicId":123, // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0 "topicUrl":"" , // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串 "articleTitle":"", // 如果这条回复是评论,则这是对应文章的标题;如果是回复帖子,为空字符串 "floorId":123 , // 该回复的楼层id,评论和帖子都用这个字段 "floor":123 // 该回复的楼层数,评论和帖子都用这个字段 } ] } ps:这接口内容有3种 1.我发的帖子,别人回帖 2.我发的回帖,别人回复 3.我发的文章评论,别人回复 }}} === 2.17 [=#point217 删除提醒] === {{{ url:http://bip.pcauto.com.cn/intf/sysnotice.jsp 作用:删除提醒 使用范围:汽车网app HTTP请求方式:post 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id act:用于区分动作,此处使用delete,即act=delete noticeId:消息id,使用【2.16 获取提醒内容】接口中的noticeId字段,如果一次性要删除多条消息,请拼接多个noticeId参数,即:noticeId=xxx¬iceId=xxx 返回参数: { "code": 0, // 0代表成功,-1代表失败 "message":"" //失败时会有此字段,提示文本 } }}} === 2.18 [=#point218 获取私信列表]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?pageSize=20&pageNo=1 作用:我的消息---私信 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo":1, "pageSize":20, "total":200, "resultList": [ { "face": "http://i1.3conline.com/images/upload/upc/face/24/28/68/12/24286812_50x50", "senderNickName": "testpcatuo",//发送方 "senderId": 24286812,//发送方 "createAt": 1372392697000, "content": "b" } ] } }}} === 2.19 [=#point219 获取个人私信]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1 作用:获取个人私信 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html 请求参数: common_session_id:用户登陆后获得的认证id userId // 对方的用户id 返回参数: { "face": "http://i1.3conline.com/images/upload/upc/face/24/28/68/12/24286812_50x50", "userName": "testpcatuo", "userId": 24286812, "result": [ { "time": "2013-01-01 02:10", "content": "这次的内容" } ] } }}} === 2.20 [=#point220 发送私信]=== {{{ url:http://bip.pcauto.com.cn/intf/message.jsp?act=create 请求参数: accountId 发送给某个用户 content 消息内容 captcha 验证码 /* * 发送限制 add by handy 2012.04.01 * 1.post 2.验证码 3.黑名单 * 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 edit by handy 2012.04.10 * 5.发送频率 50次/ID/24H * 6.白名单最多一次发送50个用户,非白名单则每次只能发一个 7.添加关键词库过滤 */ 结果返回 {code:0,message:"提示"} 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html 具体请参考汽车论坛app对该接口的使用方法 }}} === 2.21 [=#point221 删除私信]=== {{{ url:http://bip.pcauto.com.cn/intf/message.jsp 作用:删除私信 使用范围:汽车网app HTTP请求方式:post 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id act:用于区分动作,此处使用delete,即act=delete messageId:消息id,使用【2.18 获取私信列表】接口中的messageId字段,如果一次性要删除多条消息,请拼接多个messageId参数,即:messageId=xxx&messageId=xxx 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html 返回参数: { "code": 0, // 0代表成功,-1代表失败 "message":"" //失败时会有此字段,提示文本 } }}} === 2.22 [=#point222 我的帖子]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_posts.html }}} === 2.23 [=#point223 车型库首页品牌列表]=== {{{ url:http://mrobot.pcauto.com.cn/v2/price/brands?v=4.0.0 备注:在原接口(http://mrobot.pcauto.com.cn/v2/price/brands/)基础上更改 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/zhaoche.html 作用:获取车型库品牌列表 使用范围:汽车网app http请求方式:get 是否需要登录:否 请求参数:v=4.0.0 返回参数:在原接口返回的数据的基础上最顶层多加一个如下对象: { brands: [ { hot: "奥迪A6L, 普拉多, 宝马7", id: 0, letter: "", logo: "", name: "热门车系" } ], index: "", rowNum: 0 } }}} === 2.24 [=#point224 精准选车条件]=== {{{ url:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0 备注:在原条件接口(http://mrobot.pcauto.com.cn/v3/price/models/criterionv36/)基础上更改 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/shaixuan.html 作用:获取选车条件 使用范围:汽车网app http请求方式:get 是否需要登录:否 请求参数:v=4.0.0 返回参数: 1)在原接口返回数据加入变速箱条件 2)所有条件加入“不限”选项 }}} === 2.25 [=#point225 车主点评列表页]=== {{{ url: http://mrobot.pcauto.com.cn/v3/price/commentList/3404 作用:获取某车系下的车主点评列表 使用范围:汽车网app 是否需要登录:否 http请求方式:get 请求参数:车系id 原型图:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.0.0/iOS-v6/start.html#p=6_8user_comments 接口为网页,点击网页中列表,跳转协议为:pcaction://pcauto-owner-review?modelId=${id} }}} === 2.26 [=#point226 车型图片列表]=== {{{ url:车型:http://mrobot.pcauto.com.cn/v2/price/pictures?modelId=20207&fmt=json&pageSize=999&typeId=1 车系:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=4313&fmt=json&pageSize=999&typeId=1 作用:按照分类获取车型、车系图片列表 使用范围:汽车网app 是否需要登录:否 http请求方式:get 备注:与目前图集终端页使用的接口相同 }}} === 2.27 [=#point227 论坛帖子列表]=== {{{ url:http://mrobot.pcauto.com.cn/v3/bbs/newForums/14140 作用:获取帖子列表 使用范围:汽车网app 是否需要登录:否 http请求方式:get 设计稿:http://192.168.50.175/work/201309/pcauto4.0/luntan/luntan.html 请求参数:照旧 备注:按照4.0规定的算法排序http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/dev_requirement/sorting_algorithm;添加了ups和downs两个参数 返回参数: { ...... "pageNo":1, "pageSize":50, "topicList":[ { "author":{ "name":"yuking-ouyang", "nickname":"yuking-ouyang", "userId":23672097 }, "createAt":1347978864000, "flag":"精", "lastPoster":{ "name":"qz30446664", "nickname":"qz30446664", "userId":30446664 }, "replyCount":87, "title":"8.6号新A6L30技术提车作业!!半夜的作品!!", "topicId":3322726, "uri":"http://bbs.pcauto.com.cn/topic-3322726.html", "view":104676, "ups":123, "downs":123 }, ], ...... } }}} === 2.28 [=#point228 询底价页]=== {{{ 需求:重新设计询底价页[[BR]] 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]] url:待定[[BR]] }}} === 2.29 [=#point229 经销商详情页]=== {{{ 需求:重新设计经销商详情页[[BR]] 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]] 备注:添加预约试驾和促销信息,促销信息来自网站已有的数据,参考http://price.pcauto.com.cn/15214/news.html url:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40 方法:get 参数:参考3.6.0接口,areaId可以不传 }}} === 2.30 [=#point230 车型终端页]=== {{{ 需求:重新设计车型终端页;需要把同车系的所有车型都放到html里,类似文章终端的html_meta数据。[[BR]] 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/chexing.html[[BR]] url:http://mrobot.pcauto.com.cn/v3/price/modelsv40/25332 方法:GET 参数:与modelsv36相同 }}} === 2.31 [=#point231 车型对比页]=== {{{ 需求:更改为整个车型对比页都由HTML实现[[BR]] 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/duibijieguo.html[[BR]] url:待定[[BR]] }}} === 2.32 [=#point232 车主点评终端页]=== {{{ 需求:新增页面;需要把同车系的所有车型都放到html里,类似文章终端的html_meta数据。[[BR]] 原型图:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.0.0/iOS-v6/start.html#p=6_8user_comments[[BR]] url:http://mrobot.pcauto.com.cn/v3/price/commentDetail/19799 }}} === 2.33 [=#point233 预约驾车页]=== {{{ 需求:新增页面[[BR]] 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]] 备注:咨询小虎,看提交到什么地方 url:待定[[BR]] }}} === 2.34 [=#point234 车型降价信息]=== {{{ url:http://mrobot.pcauto.com.cn/v3/price/getDepreciateModelBySerialId/3544?areaId=1&pageNo=1&pageSize=20 作用:获取某个车系下在售车型的降价信息 使用范围:汽车网app 是否需要登录:否 http请求方式:get 请求参数: serialId:车系id areaId:城市id pageNo:第几页 pageSize:每页显示多少条 返回参数: { "models": [ { "modelId": "24032", "phone": "4008600876", "modelName": "科鲁兹 2013款 1.6 SL MT", "originalPrice": "10.89 万", "image": "http://img.pcauto.com.cn/images/auto3/dealer/20115/27/13064891712435570.jpg", "dealerName": "广州安骅雪佛兰 ", "nowPrice": "8.89 万", "city": "广州" }, { "modelId": "24282", "phone": "4008600876", "modelName": "科鲁兹 2013款 1.6 SL MT 天窗版", "originalPrice": "11.29 万", "image": "http://img.pcauto.com.cn/images/auto3/dealer/20115/27/13064891712435570.jpg", "dealerName": "广州安骅雪佛兰 ", "nowPrice": "9.29 万", "city": "广州" }, { "modelId": "24033", "phone": "4008600876", "modelName": "科鲁兹 2013款 1.6 SL MT 天地版", "originalPrice": "11.39 万", "image": "http://img.pcauto.com.cn/images/auto3/dealer/20115/27/13064891712435570.jpg", "dealerName": "广州安骅雪佛兰 ", "nowPrice": "9.39 万", "city": "广州" } ], "total": 17, "pageNo": 1, "pageSize": 3 } }}} === 2.35 [=#point235 文章终端和帖子]=== {{{ url:http://mrobot.pcauto.com.cn/v3/cms/articles/3219885?articleTemplate=4.0.0 & http://mrobot.pcauto.com.cn/v2/bbs/topics/4172349?topicTemplate=4.0.0 作用:获取文章或者内容 使用范围:汽车网app 是否需要登录:否 http请求方式:get 请求参数: articleTemplate=4.0.0,文章 topicTemplate=4.0.0,帖子 返回参数: 在原来的基础上,在html_meta中添加isFavorited,ups和downs三个字段,分别表示是否已收藏和该对象的顶踩数 }}} === 2.36 [=#point236 车型库图集类别]=== {{{ url:madmin配置项:http://mrobot.pcauto.com.cn/configs/pcauto_albums_types 作用:获取车型库图集列表的类别 使用范围:汽车网app 是否需要登录:否 备注:madmin出 数据格式: { "types": [ { "name": "外观", "id": "1" }, { "name": "内饰", "id": "2" }, { "name": "空间", "id": "8" }, { "name": "其他", "id": "3" } ] } }}} === 2.37 [=#point237 编辑订阅列表]=== {{{ url: 汽车网:待定 作用:编辑订阅列表 使用范围:汽车网app HTTP请求方式:post 是否需要登录:是 设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_dy.html 请求参数:common_session_id:用户登陆后获得的认证id serials,json数据,包含一个数组,数组的元素就是一款车的基本数据: [{"id":123, "img":"", "name":"福克斯", "price":""}, ...] 返回参数: { "code": 1, // 1代表成功,0代表失败 "msg": "" // 结果提示 } }}} === 2.38 [=#point238 车型库首页热门车系列表]=== {{{ url:madmin 配置项:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials 作用:车型库首页热门车系 使用范围:汽车网app HTTP请求方式:get 是否需要登录:是 设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/zhaoche.html 请求参数:none 返回参数: { "manufacturers": [ { "name": "热门车系", "serials": [ { "id": 9550, "name": "奥迪A3", "kind": "紧凑型车", "priceRange": "null", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg", "count": 0 }, { "id": 8670, "name": "奥迪Q3", "kind": "中型SUV", "priceRange": "28.5~42.88 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8670.jpg", "count": 6 }, { "id": 4313, "name": "奥迪A6L", "kind": "中大型车", "priceRange": "38.3~74.26 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4313.jpg", "count": 59 }, { "id": 4457, "name": "奥迪Q5", "kind": "中大型SUV", "priceRange": "35.85~56.77 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4457.jpg", "count": 20 }, { "id": 3524, "name": "奥迪A4L", "kind": "中型车", "priceRange": "27.28~57.81 万", "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg", "count": 32 } ] } ] } }}} === 2.39 [=#point239 车系页]=== {{{ 接口地址: 需求:更改为整个车系页都由HTML实现[[BR]] 请求参数: modelIds,记录在客户端本地的已经加入对比的车型id列表 返回参数: 参考设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/chexi.html[[BR]] 该页面包含一个车型列表,里面的每个车型都需要判断是否已经加入对比,可根据参数modelIds来进行判断。 提交js函数isSubscribe(),用来判断是否已经订阅该车系,已订阅返回1,否则返回0。 其中包含几个和客户端交互的地方: 1,点击图片,pcautobrowser://serial-Photo/${id}?type=serial 2,点击车主点评,待定 3,点击询底价,pcautobrowser://auto-ask-price/?modelId=${}&modelName=${}&dealerId=${}$dealerName=${} 4,点击添加对比,pcaction://addCompareModel/${modelId},同时改变该按钮的状态 }}} === 2.40 [=#point240 新增栏目]=== {{{ 说明:汽车网资讯客户端v4.0新增“路边社”、“每日猜车”、“汽车视频”、“网友帮帮忙”栏目,这些栏目不会在v4.0以下的客户端显示出来。[[BR]] 这些栏目根据文章右上角的栏目名称进行跳转,即当文章右上角的栏目名称显示为“路边社”时,点击跳转到“路边社”栏目。 “路边社”的栏目id:11 “每日猜车”的栏目id:12 “汽车视频”的栏目id:13 “网友帮帮忙”的栏目id:14 }}} === 2.41 [=#point241 热门帖子]=== {{{ 修改该接口:http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20 在原来的基础上添加字段 返回参数: "topicList":[ { "title":"todo", //帖子标题 "createAt":123, //格式是时间戳,创建或最终修改时间 "replyCount":100, //帖子的回复数 "replyView":100, //帖子的阅读数 "author":"todo", //帖子的作者 "topicId":"123456", //帖子id "image":"http://xxxx.png", //帖子的导读图 "ups":123, //新增,顶 "downs":123, // 新增,踩 "forumId":123, // 新增,所属论坛id "forumName":路虎 // 新增,所属论坛名字 } ] }}} === 2.42 [=#point242 汽车网车系列表]=== {{{ url:http://mrobot.pcauto.com.cn/v3/price/searchSerials?q=大众 说明:搜索接口,搜索某品牌下的车系。 }}} === 2.43 [=#point243 判断版块、帖子是否已经收藏]=== {{{ url:http://bbs.pcauto.com.cn/action/user/check_favorite.jsp 作用:判断某个版块、帖子是否已经收藏 使用范围:汽车网app 是否需要登录:是 http请求方式:post 请求参数: common_session_id:用户登陆后获得的认证id fid:版块id tid:帖子id 返回参数:如果已经登陆并且版块或者帖子已经收藏,返回收藏id,否则返回-1 }}} === 2.44 [=#point244 车型库相关网页的备注]=== {{{ ||"pcaction://pcauto-ask4price?"; || //点击询价||pcaction://pcauto-ask4price?|| ||"pcaction://webview_tel/"; || //点击打电话|||| ||"pcaction://pcauto-model-album/"; || //点击车型终端页图集||pcautobrowser://pcauto-model-album/|| ||"pcautobrowser://car-parameter/"; || //点击车型终端页参数||pcautobrowser://car-parameter/|| ||"pcaction://pcauto-model-sale?"; || //点击车型终端页经销商||pcautobrowser://pcauto-model-sale?|| ||"pcautobrowser://compare"; || //点击车型终端页对比|||| ||"pcaction://pcauto-model-map?"; || //点击经销商详情页地图||pcautobrowser://pcauto-model-map?|| ||"pcaction://pcauto-appoint4driving?"; || //点击经销商详情页预约试驾||pcautobrowser://pcauto-appoint4driving?|| ||"pcaction://pcauto-owner-review?"; || //点击车主点评列表||pcautobrowser://pcauto-owner-review?|| }}} == 3.开发时间、负责人、进度和实现方式== ||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||=接口进度(百分比)=||=接口实际[[BR]]完成时间=||=实现方式=|| ||第一批|| 首页 ||2.1 [#point201 左侧主菜单 ] ||- || - || - || 已上线 || - || madmin配置 ||第一批|| 首页 ||2.2 [#point202 默认订阅栏目 ] ||- || - || - || 已上线 || - || madmin配置 ||第一批|| 首页 ||2.3 [#point203 头条 ] ||- || - || - || 已上线 || - || mrobot实现 ||第一批|| 车系聚合页 ||2.3.1 [#point203 车系聚合页 ] ||- || - || - || 已上线 || - || mrobot实现 ||第一批|| 文章、帖子、图集 ||2.4 [#point204 赞和踩 ] ||- || - || - || 已上线 || - || mrobot-data实现 ||第一批|| 资讯栏目 ||2.5 [#point205 搜索栏目文章 ] ||- || - || - || 已上线 || - || mrobot实现 ||第一批|| 个人中心 ||2.6 [#point206 新消息 ] ||- || 个人中心同事 ||-|| 已上线 || - || mrobot代理 ||第一批|| 左侧菜单 ||2.7 [#point207 您可能对以下内容感兴趣 ] ||- || - ||-|| 已上线 || - || madmin配置 ||第一批|| 我的收藏 ||2.8 [#point208 收藏夹信息---文章 ] ||-|| 个人中心同事 ||-|| 已上线 || - || mrobot代理 ||第一批|| 我的收藏 ||2.9 [#point209 收藏夹信息---帖子 ] ||- || 个人中心同事 ||-|| 已上线 || - || mrobot代理 ||第一批|| 我的收藏 ||2.10 [#point210 收藏夹信息---车型 ] ||- || 个人中心同事 ||-|| 已上线 ||-|| mrobot代理 ||第一批|| 我的收藏 ||2.11 [#point211 添加收藏 ] ||- || 个人中心同事 ||-|| 已上线 ||-|| 外部系统实现 ||第一批|| 我的收藏 ||2.12[#point212 删除收藏 ] || - || 个人中心同事 ||-|| 已上线 || - || 外部系统实现 ||第一批|| 我的订阅 ||2.13 [#point213 获取我的订阅 ] ||- || 个人中心同事 ||-|| 已上线 ||-|| mrobot代理 ||第一批|| 我的订阅 ||2.14 [#point214 添加我的订阅 ] ||- || 个人中心同事 ||-|| 已上线 || - || 外部系统实现 ||第一批|| 我的订阅 ||2.15 [#point215 删除我的订阅 ] ||- || 个人中心同事 ||-|| 已上线 || - || 外部系统实现 ||第一批|| 我的消息 ||2.16 [#point216 获取提醒内容 ] ||- || 个人中心同事 ||-|| 已上线 || - || mrobot代理 ||第一批|| 我的消息 ||2.17 [#point217 删除提醒 ]||- || 个人中心同事 ||-|| 已上线 || - || 外部系统实现 ||第一批|| 我的消息 ||2.18 [#point218 获取私信列表 ] ||- || 个人中心同事 ||-|| 可内测 || - || mrobot代理 ||第一批|| 我的消息 ||2.19 [#point219 获取个人私信 ] ||- || 个人中心同事 ||-|| 静态数据 || - || mrobot代理 ||第一批|| 我的消息 ||2.20 [#point220 发送私信 ] ||-|| 个人中心同事 ||-|| 已上线 ||- || 外部系统实现 ||第一批|| 我的消息 ||2.21 [#point221 删除私信 ] ||-|| 个人中心同事 ||-|| 已上线 ||- || 外部系统实现 ||第一批|| 我的帖子 ||2.22 [#point222 获取我的帖子 ] ||-|| 个人中心同事 ||-|| 未排序、未添加顶数和踩数、缺少image ||- || mrobot代理 ||第一批|| 车型库首页品牌列表 ||2.23 [#point223 车型库首页品牌列表 ] ||-|| - ||-|| 可内测 ||- || mrobot代理 ||第一批|| 精准选车条件 ||2.24 [#point224 精准选车条件 ] ||-|| - ||-|| 可内测 ||- || mrobot实现 ||第一批|| 车主点评列表 ||2.25 [#point225 获取车主点评列表 ] ||-|| 车型库同事 ||-|| 完成 ||- || mrobot实现 ||第一批|| 图片终端页 ||2.26 [#point226 车型图片列表 ] ||-|| 车型库同事 ||-|| 完成 ||- || mrobot代理 ||第一批|| 论坛帖子列表 ||2.27 [#point227 论坛帖子列表 ] ||-|| 论坛同事 ||-|| 已上线 ||- || mrobot代理 ||第一批|| 询底价页 ||2.28 [#point228 询底价页 ] ||-|| 前端同事 ||-|| - ||- || mrobot实现 ||第一批|| 经销商详情页 ||2.29 [#point229 经销商详情页 ] ||-|| 车型库、前端同事 ||-|| 完成 ||- || mrobot实现 ||第一批|| 车型终端页 ||2.30 [#point230 车型终端页 ] ||-|| 车型库、前端同事 ||-|| 完成 ||- || mrobot实现 ||第一批|| 车型对比页 ||2.31 [#point231 车型对比页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现 ||第一批|| 车主点评终端页 ||2.32 [#point232 车主点评终端页 ] ||-|| 车型库、前端同事 ||-|| 完成 ||- || mrobot实现 ||第一批|| 预约驾车页 ||2.33 [#point233 预约驾车页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现 ||第一批|| 车型降价信息 ||2.34 [#point234 车型降价信息 ] ||-|| 车型库同事 ||-|| 可内测 ||- || mrobot代理 ||第一批|| 车主点评终端页 ||2.35 [#point235 文章终端和帖子 ] ||-|| - ||-|| - ||- || mrobot实现 ||第一批|| 车型库图集类别 ||2.36 [#point236 车型库图集类别 ] ||-|| - ||-|| 完成 ||- || mamdin实现 ||第一批|| 车型库图集类别 ||2.37 [#point237 编辑订阅列表 ] ||-|| 个人中心同事 ||-|| - ||- || 外部系统实现 ||第一批|| 车型库图集类别 ||2.38 [#point238 车型库首页热门车系列表 ] ||-|| - ||-|| 完成 ||- || madmin实现 ||第一批|| 车系页 ||2.39 [#point239 车系页 ] ||-|| - ||-|| - ||- || mrobot代理 ||第一批|| 栏目页 ||2.40 [#point240 新增栏目 ] ||-|| - ||-|| 完成 ||- || mamdin实现 ||第一批|| 论坛 ||2.41 [#point241 热门帖子 ] ||-|| - ||-|| 已上线 ||- || mrobot代理 ||第一批|| 论坛 ||2.42 [#point242 汽车网车系列表 ] ||-|| - ||-|| 可内测 ||- || mrobot代理 ||第一批|| 论坛 ||2.43 [#point243 判断版块、帖子是否已经收藏 ] ||-|| - ||-|| 完成 ||- || 外部系统实现