[[TOC]] == 1.基本约定 == {{{ web开发机代理：192.168.10.199 端口为 1080 接口通用参数 req_enc=utf-8(必须放url后面) resp_enc=utf-8(必须放url后面) common_session_id=xxxx(以cookies中的优先) 接口URL: 接口URL ||参数名||类型||必须||说明|| 说明文档参数：添加某特定参数可以直接看接口文档 是否需要登录：是|否 返回格式：json|xml|ssi, 缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（） 缓存时间：缓存时间 返回结果：结果可能情况 }}} == 2.接口列表 == === 2.1 [=#point2.1 资讯] === === 2.1.1 [=#point2.1.1 文章收藏批量操作] === 请求url: [[BR]]后端地址: [[BR]]请求方式: [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 2.1.2 [=#point2.1.2 获取账号的收藏文章] === 请求url: [[BR]]后端地址: [[BR]]请求方式: [[BR]]是否需要登录:是 [[BR]]返回格式:JSON [[BR]]缓存方式:接口缓存 [[BR]]缓存时间:60分钟 [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[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]]说明： [[BR]]客户端4.5版本的请求url：http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=modelIds=28350,32262 [[BR]]客户端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 条件筛选增加产地] === [[BR]]说明：找车条件筛选新增产地这个选项 请求url: （1）http://mrobot.pcauto.com.cn/buy/price/chooseOption （2）http://mrobot.pcauto.com.cn/buy/price/search （3）http://mrobot.pcauto.com.cn/v3/price/search [[BR]]后端地址: [[BR]]请求方式: [[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 [=#point4.1.1 优惠降价列表] === （接口开发完成已上线） [[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 } == 3.车型库+商城优化的接口列表 == === 3.1 [=#point3.1 索引表] === [[BR]]mrobot请求url: [[BR]]原接口： [[BR]]HTTP请求方式: [[BR]]是否需要登录:false [[BR]]返回格式: [[BR]]缓存方式: [[BR]]缓存时间: [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| [[BR]]返回结果: === 3.2 [=#point3.2 车系综述页] === [[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/serialv45/4665?rid=1013 [[BR]]原接口： [[BR]]http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4665 [[BR]]http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=4665 [[BR]]http://price.pcauto.com.cn/interface/iphone/get_serialGroup_dealerCount.jsp?serialGroupId=4665&rid=4 [[BR]]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]]原接口： [[BR]]http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=9398 [[BR]]http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId=20208&areaId=117 [[BR]]http://price.pcauto.com.cn/interface/iphone/model_compete.jsp?mid=20208 [[BR]]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]]原接口： [[BR]]http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_detail_json.jsp [[BR]]http://price.pcauto.com.cn/dealer/interface/tuangou/dealer_serialgroup_photo_json.jsp [[BR]]http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_models_json.jsp [[BR]]http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_dealers_json.jsp [[BR]]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 车系经销商] === [[BR]]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]]返回结果: