[[TOC]] == 1.基本约定 == [[BR]]web开发机代理：192.168.10.199 端口为 1080 [[BR]]接口通用参数 [[BR]]req_enc=utf-8(必须放url后面) [[BR]]resp_enc=utf-8(必须放url后面) [[BR]]common_session_id=xxxx(以cookies中的优先) [[BR]]接口URL: 接口URL ||参数名||类型||必须||说明|| 说明文档参数：添加某特定参数可以直接看接口文档 [[BR]]是否需要登录：是|否 [[BR]]返回格式：json|xml|ssi, [[BR]]缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（） [[BR]]缓存时间：缓存时间 [[BR]]返回结果：结果可能情况 == 2.接口列表 == === 2.1 [=#point2.1 资讯] === === 2.1.1 [=#point2.1.1 文章收藏批量操作] === （接口已完成，测试请连web开发机代理） [[BR]]请求url:http://mrobot.pcauto.com.cn/v2/cms/batchArticles [[BR]]后端地址:http://bip.pcauto.com.cn/intf/article.jsp [[BR]]请求方式:post [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||act||String||必须||act=batchDelArtCollect表示批量取消收藏|| ||articleIds||String||必须||文章id串，“，”逗号分隔，如：1258,46816|| ||siteId||int||必须||站点id：(1:online(电脑网);2:auto(汽车网);3:games(游戏网);4:lady(时尚网);5:baby(亲子网);6:house(家居网))|| [[BR]]返回结果: [[BR]]{"code":1,"message":"收藏/取消收藏文章成功"} [[BR]]{"code":-1,"message":"登录后才能操作"} === 2.1.2 [=#point2.1.2 获取账号的收藏文章] === （接口已完成，测试请连web开发机代理） [[BR]]请求url:http://mrobot.pcauto.com.cn/v2/cms/getMyCollection [[BR]]后端地址:http://bip.pcauto.com.cn/intf/article.jsp [[BR]]请求方式:get [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||siteId||int||必须||站点id：(1:online(电脑网);2:auto(汽车网);3:games(游戏网);4:lady(时尚网);5:baby(亲子网);6:house(家居网))|| ||pageNo||String||非必须||页号(不传默认为1)|| ||pageSize||String||非必须||每页显示多少条数据(不传默认为20，最小值为1，最大值为100)|| [[BR]]返回结果: { articleList: [ { collectid: "142734", //收藏id[[BR]] id: "2048279", //文章id[[BR]] image: "http://img0.pcauto.com.cn/pcauto/1208/14/g_2048279_1344900311845.jpg", [[BR]] image2: "",[[BR]] preView: "雪铁龙对新世嘉相当重视，厂家甚至将它看成是一款全新换代车型。而新车究竟新在哪里?", [[BR]] pubDate: "2012-08-14", [[BR]] tags: "世嘉;雪铁龙;东风雪铁龙", [[BR]] title: "雪铁龙新世嘉评测 主要的变化来自外观", [[BR]] topicUrl: "http://roadtest.pcauto.com.cn/yc/1207/2048279.html", [[BR]] url: "http://www.pcauto.com.cn/pingce/yc/1207/2048279.html" [[BR]] },...... ] } === 3.1 [=#point3.1 找车] === === 3.1.1 [=#point3.1.1 车系车型图片筛选条件] === 请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0&colorId=0&typeId=0&v=4.5.0 [[BR]]后端地址: [[BR]]请求方式:GET [[BR]]是否需要登录:否 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||serialId||string||必须||车系id|| ||modelId||string||可选||车型id，查车系的时候不用传|| ||colorId||string||可选||颜色id，查全部颜色的时候不用传|| ||typeId||string||可选||类型id，查全部类型得时候不用传|| ||v||string||必须||v=4.5.0 4.5版本增加类型细化，颜色值|| [[BR]] 返回结果:[[BR]] {{{ { colors: [ { count: "479", id: "44908", isMetal: "0", name: "平安白", value: "(245,245,245)" } ], models: [ { count: "91", id: "34205", name: "2015款 1.4 手动 舒适版" } ], types: [ { id: "1", name: "外观", section: [ { id: "1", name: "全部" } ] } ] } }}} [[BR]] === 3.1.2 [=#point3.1.2 车型综述页] === 请求url： [[BR]]说明： {{{ 客户端4.5版本的请求url：http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=modelIds=28350,32262 客户端4.6新增一个跳转协议，为了不影响4.5版本使用，4.6需要使用新版本接口 }}} [[BR]]新增协议如下： [[BR]]点击竞争车型协议pcautobrowser://model/30499?serialId=(车系id) 30499为车型id === 3.1.3 [=#point3.1.3 热门品牌] === （接口已完成上线，品牌可从madmin.pconline.com.cn的管理配置pcauto_hot_brands中修改） [[BR]]请求url:http://mrobot.pcauto.com.cn/configs/pcauto_hot_brands [[BR]]后端地址:无 [[BR]]请求方式:get [[BR]]是否需要登录:否 [[BR]]返回格式:JSON [[BR]]缓存方式:无 [[BR]]缓存时间:0 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| 无 [[BR]]返回结果: {{{ "brands": [ { "id": 2, "letter": "D", "logo": "http://www1.pcauto.com.cn/piclib/2.png", "name": "大众" }, { "id": 10, "letter": "F", "logo": "http://www1.pcauto.com.cn/piclib/10.png", "name": "丰田" }, …… ] }}} === 3.1.4 [=#point3.1.4 条件筛选增加产地] === （接口已完成，测试请连web开发机代理） [[BR]]说明：找车条件筛选新增产地这个选项 [[BR]]请求url: {{{ （1）http://mrobot.pcauto.com.cn/buy/price/chooseOption （2）http://mrobot.pcauto.com.cn/buy/price/search该接口采用新的接口，不再调用buy/price/search(此接口用于入报价)，现在调用http://mrobot.pcauto.com.cn/v3/price/chooseOptionLink(参数不变) （3）http://mrobot.pcauto.com.cn/v3/price/search }}} [[BR]]后端地址: （1）http://price.pcauto.com.cn/interface/iphone/price_choose_option.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是：http://dev3.pcauto.com.cn:8001) （2）http://price.pcauto.com.cn/interface/iphone/price_choose_option_linkage.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是：http://dev3.pcauto.com.cn:8001) （3）http://price.pcauto.com.cn/interface/iphone/query_serial_group.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是：http://dev3.pcauto.com.cn:8001) [[BR]]请求方式:get [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 4.1 [=#point4.1 个人中心] === === 4.1.1 [=#point4.1.1 获取系统消息] === （接口已完成，测试请连web开发机代理） [[BR]]说明：需要新版本接口，因为4.5要过滤a标签，4.6不需要过滤 [[BR]]原请求url:http://mrobot.pcauto.com.cn/v3/bbs/getSysNotice?status=-1&pageSize=20&pageNo=1&common_session_id=DA4C99E3FDF2FDE541D7A9319891798C2DD2AFCE4E6EEB28 [[BR]]后端地址:http://bip.pcauto.com.cn/intf/sysnotice.jsp [[BR]]请求方式:GET [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||status||string||必须||-1为已读和未读，0表示未读，1表示已读|| ||common_session_id||string||必须|| 登录session|| ||v||string||可选|| 4.6.0表示4.6版本，不过滤标签|| ||pageNo||string||可选||页码|| ||pageSize||string||可选||一页条数，默认20，最大500|| [[BR]] 返回结果:[[BR]] {{{ { pageCount: 1, pageNo: 1, pageSize: 20, resultList: [ { accountId: 33375426, content: "年底抢楼送大奖，说出对新年愿望祝福——送儿童安全座椅、投影机、行车记录仪、京东购物卡、移动电源！！！http://bbs.pcauto.com.cn/topic-5955076.html", createTime: 1417500858000, groupSend: 1, groupType: 0, id: 124624885, senderId: 0, siteId: 2, status: 1, type: { groupType: 1, id: 0, name: "系统消息", siteId: 0, templateId: 0 }, typeId: 41 } ], total: 13 } }}} [[BR]]content字段的跳转内容加上html标签，客户端做识别和跳转 === 5.1 [=#point5.1 优惠] === === 5.1.1 [=#point5.1.1 优惠降价列表] === （接口已完成，测试请连web开发机代理） [[BR]]请求url:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange [[BR]]HTTP请求方式:GET [[BR]]是否需要登录:false [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]说明:增加价格区间和级别的筛选条件 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||string||必须||地区id|| ||brandId||string||可选||品牌id|| ||serialId||string||可选||车系id|| ||modelId||string||可选||车型id|| ||orderBy||string||必须||popularity, newest, discountRange, lowestPrice；分别指按车型热度，按最新，按降价幅度，按最低价格|| ||ps||string||可选||最低价格，如13，单位万元|| ||pe||string||可选||最高价格，单位万元|| ||jb||string||可选||级别，如71|| [[BR]]返回结果: {{{ { "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 } }}} === 6.1 [=#point6.1 论坛] === === 6.1.1 [=#point6.1.1 帖子页] === （接口已完成，测试请连web开发机代理） [[BR]]备注:获取文章或者帖子内容 [[BR]]请求URL:http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 [[BR]]HTTP请求方式：get [[BR]] 是否需要登录：否 [[BR]] 返回格式：html页面 [[BR]] 缓存方式：无 [[BR]] 缓存时间：无 [[BR]] 请求参数： [[BR]] 帖子ID [[BR]] pageNo：页码 [[BR]] pageSize：一页条数 [[BR]] picRule：获取图片的网络访问方式 [[BR]] authorId：作者ID [[BR]] topicTemplate=4.0.0 [[BR]] app=pcautobrowser [[BR]] size：字体大小 [[BR]] mode：阅读模式：无参数 白天；night 晚间 [[BR]]请求后端URL： [[BR]] http://bbs.pcauto.com.cn/rest/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 [[BR]] 请求后端参数： [[BR]] pageNo：页码 [[BR]] pageSize：一页条数 [[BR]] picRule：获取图片的网络访问方式 [[BR]] authorId：作者ID [[BR]] topicTemplate=4.0.0 [[BR]] app=pcautobrowser [[BR]] size：字体大小 [[BR]] 请求后端URL： [[BR]] http://bbs.pcauto.com.cn/action/user/check_favorite.jsp //获取帖子在个人中心的收藏id [[BR]]请求后端参数： [[BR]] tid：4592911 [[BR]]4.6版本加了回复之后的调用函数：addComments(postId,topicId);///////postId是新回复后新生成的postId,topicId是文章id,调用后会原页面最下端新加一个回复数据。 [[BR]]页面加入2个广告位，一个是文字信息，一个是图片信息 [[BR]] [[BR]]
[[BR]] [[BR]] [[BR]]
[[BR]] [[BR]] 相应在文字那里，客户端插入eg:东风日产全新蓝鸟5.0全新上市敬请推广 [[BR]] 图文广告，客户端插入eg:推广 == 3.车型库+商城优化的接口列表 == === 3.1 [=#point3.1 索引表] === [[BR]]mrobot请求url: [[BR]]原接口： [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: {{{ { "serial_dealer": [ 3745 ], "serial_news": [ 4450 ], "model_dealer”:[17277],”model_news": [ 34943, 25322 ] } }}} === 3.2 [=#point3.2 车系综述页] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/serialv45/4665?rid=1013 [[BR]]原接口： {{{ http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4665 http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=4665 http://price.pcauto.com.cn/interface/iphone/get_serialGroup_dealerCount.jsp?serialGroupId=4665&rid=4 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=933&callback=list }}} [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.3 [=#point3.3 车型综述页] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/modelsv45/20208?areaId=117 [[BR]]原接口： {{{ http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=9398 http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId=20208&areaId=117 http://price.pcauto.com.cn/interface/iphone/model_compete.jsp?mid=20208 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=933&callback=list }}} [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.4 [=#point3.4 车系车型优惠列表] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange&serialId=3225 [[BR]]原接口:http://price.pcauto.com.cn/dealer/interface/app/market_json.jsp [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.5 [=#point3.5 促销优惠终端页] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/promotionDetailv45/6874084?type=0&modelId=23170 [[BR]]原接口:http://price.pcauto.com.cn/dealer/interface/app/dealer_market_json.jsp [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.6 [=#point3.6 活动列表] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/activityListv45/1?pageNo=1&pageSize=20 [[BR]]原接口:http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=1 [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.7 [=#point3.7 活动详情页] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/activityDetailv45/552?areaId=1&serialId=0&modelId=0&name=&tel=&dId=d5d5ceb98978c614d82e578320e1fce6c0e2bea9 [[BR]]原接口： {{{ http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_detail_json.jsp http://price.pcauto.com.cn/dealer/interface/tuangou/dealer_serialgroup_photo_json.jsp http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_models_json.jsp http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_dealers_json.jsp http://price.pcauto.com.cn/interface/cms/region_400_json.jsp }}} [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.8 [=#point3.8 车系经销商] === mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv45?serialId=3225&areaId=1 [[BR]]原接口:http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?serialId=3544&areaId=1&pageNo=1&pageSize=20&dealerType=1 [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: