== 车型库项目接口 == === 目录 === 1. [#point100 开发时间，负责人及进度汇报 ] 2. [#point200 mrobot的接口 ] 2.1 [#point201 getSerialListByBrandId ] 2.2 [#point202 getModelListBySerialId ] 2.3 [#point203 getPriceList ] 2.4 [#point204 getSerialListByPrice] 2.5 [#point205 getArticleListBySerialId ] 2.6 [#point206 SendCommentWihSerialId ] 2.7 [#point207 getPhotoBySerialId ] 2.8 [#point208 getPhotoBySerialIdTypeId ] 2.9 [#point209 口碑 ] 2.10 [#point210 车型终端概述 ] 2.11 [#point211 车型终端参数 ] 2.12 [#point212 车型终端经销商] 2.13 [#point213 车型对比结果 ] 2.14 [#point214 购车计算器 ] 3. [#point300 配合的接口(产品库接口及编辑出的接口) ] 3.1 [#point301 通过品牌ID得到车系列表 ] 3.2 [#point302 通过车系ID得到车型列表 ] 3.3 [#point303 通过价格返回车系列表（按首字母顺序排） ] 3.4 [#point304 通过车系ID得到相关文章 ] 3.5 [#point305 发表车系评论 ] 3.6 [#point306 口碑 ] 3.7 [#point307 购车计算器 ] 4. [#point400 测试环境接口配置 ] 5. [#point500 修改历史 ] == 1. [=#point100 开发时间，负责人及进度汇报 ]== ||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||= 接口进度（百分比） =||=接口实际[[BR]]完成时间=||=接口确认=|| ||第一批|| 品牌列表页(首页) || 以前的接口 || - || - || - || - || - || - || ||第一批|| 价格列表页(首页) ||2.4 [#point204 getSerialListByPrice] [[BR]] 2.3 [#point203 getPriceList ] || - || 3.3 [#point303 通过价格返回车系列表（按首字母顺序排） ] || 8/3 ||0%||接口实际完成时间||接口确认|| ||第一批|| 首页搜索状态 || - || - || - || - || - || - || - || ||第一批|| 品牌内页 || 2.1 [#point201 getSerialListByBrandId ] || - || 3.1 [#point301 通过品牌ID得到车系列表 ] || 8/3 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车系终端（概述） || 2.2 [#point202 getModelListBySerialId ] || - || 3.2 [#point302 通过车系ID得到车型列表 ] || 8/5 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车系终端（文章） || 2.5 [#point205 getArticleListBySerialId ] || 是 || 3.4 [#point304 通过车系ID得到相关文章 ] || 8/5 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车系终端（口碑） || 2.9 [#point209 口碑 ] || 是 || 3.6 [#point306 口碑 ] || 8/7 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车系终端（图片） || 2.7 [#point207 getPhotoBySerialId ] || - || 以前的接口 || 8/7 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车型终端（概述） || 2.10 [#point210 车型终端概述 ] || 是 || 以前的接口 || 8/9 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车型终端（参数） || 2.11 [#point211 车型终端参数 ] || 是 || 以前的接口 || 8/9 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 车型终端（经销商） || 2.12 [#point212 车型终端经销商] || 是 || 以前的接口 || 8/11 ||0%||接口实际完成时间||接口确认|| ||=第二批=|| 收藏夹（车型） || - || - || - || - || - || - || - || ||=第二批=|| 收藏夹（车系） || - || - || - || - || - || - || - || ||第三批|| 图片列表 || 2.8 [#point208 getPhotoBySerialIdTypeId ] || - || 以前的接口 || 8/11 ||0%||接口实际完成时间||接口确认|| ||第三批|| 图片终端 || - || - || - || - || - || - || - || ||第三批|| 搜索页 || - || - || - || - || - || - || - || ||第三批|| 搜索条件 || - || - || - || - || - || - || - || ||第三批|| 搜索结果 || - || - || - || - || - || - || - || ||第三批|| 对比结果 || 2.13 [#point213 车型对比结果 ] || 是 || 以前的接口 || 8/14 ||0%||接口实际完成时间||接口确认|| ||第三批|| 计算器详细页 || 2.14 [#point214 购车计算器 ] || 是 || 3.7 [#point307 购车计算器 ] || 8/14 ||0%||接口实际完成时间||接口确认|| ||第三批|| 城市选择页 || - || - || - || - || - || - || - || ||第三批|| 评分页 || 2.6 [#point206 SendCommentWihSerialId ] || - || 3.5 [#point305 发表车系评论 ] || 8/16 ||0%||接口实际完成时间||接口确认|| == 2. [=#point200 mrobot的接口 ] == mrobot自身的接口，由客户端调用 === 2.1 [=#point201 getSerialListByBrandId ] === {{{ 请求方式get 请求参数: 　　brandId 品牌Id Url: http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/ 范例： http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/2 返回： { manufacturers:[ { name:"一汽奥迪"， serials: [ { id:"1", name："奥迪A5", kind:"suv", priceRange:"37.28~56.7"， photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" }, { id:"1", name："奥迪A6L" kind:"suv", priceRange:"37.28~56.7"， photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" } ] }, { name:"进口奥迪"， serials: [ { id:"1", name："奥迪A5" kind:"suv", priceRange:"37.28~56.7"， photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" } ] }] } 备注： name 厂家名称 id 车系id name 车系名称 kind级别 priceRange指导价 photo 图片 }}} === 2.2 [=#point202 getModelListBySerialId ] === {{{ 请求方式get 请求参数: 　　SerialId 车系id 返回： { brandId:235238, serialGroupName:”奥迪Q5”, bbsId:"16856", photo:"http://XXXXX" kind:"SUV", priceRange:"123~125万", modelTotal:"5", ceditNumber:"123456", advantage:"好啊好", disadvatage:"衰啊衰", data:[ { id:"19082", title:"奥迪进取型", price:"1-5", status:"在售" }, { id:"19083", title:"奥迪技术型", price:"1-3", status:"停产" } ] } brandId 品牌ID bbsId 对应论坛id photo 图片链接 kind 级别 priceRange官方报价 modelTotal 车型总数 ceditNumber 贷款电话 advantage 优点 disadvatage 缺点 id 车型id title 车型名称 price 报价 status 在售 停产等 }}} === 2.3 [=#point203 getPriceList ] === {{{ 请求方式get 请求参数 无 返回： { data:[ { indexId:”1”, title:”1~3万” 　　}, 　　{ indexId:”2”, title:”4~9万” 　　} 　　] } indexId 价格范围索引 title 价格范围内容 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 }}} === 2.4 [=#point204 getSerialListByPrice ] === {{{ 请求方式get 请求参数: 　　indexed 对应1.3返回的indexId，用于搜索该范围内的车系数据，例如1.3返回 { data:[ { indexId:”1”, title:”1~3万” 　　}, 　　{ indexId:”2”, title:”4~9万” 　　} 　　] } 当客户端请求indexId为1时，则返回1～3万范围内的车系信息 　　 返回： { data:[ { manufacturerName:"奥迪"， 　　letter:"A", photo:"http://XXXX" Serials: [ { id:"1", name："奥迪A5", photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" }, { id:"1", name："奥迪A6L" photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" } ] }, { manufacturerName:"阿斯顿马丁"， 　　letter:"A", photo:"http://XXXX" Serials: [ { id:"1", name："奥迪A5" photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" } ] }] } manufacturerName：厂商名 Letter：索引字母 Photo：厂商logo Serials: 车系列表 　　Id:车型id 　　Name：车型名称 　　Photo：车型logo }}} === 2.5 [=#point205 getArticleListBySerialId ] === {{{ 请求方式get 请求参数: 　　serialId 车系id 　　pageNum 默认0，第几页 　　pageCount 默认0，每页多少篇文章，0则返回所有相关文章 　　 　　返回： { 　　Count:20, 　　pageNo:1, 　　pageSize:20 data:[ { id:"123", title:"新车", channel:"新闻", commentNum:"12", "image":"http://xxdxx.jpg" }, { id:"123", title:"新车", channel:"新闻", commentNum:"12", "image":"http://xxdxx.jpg" } ] } id 文章id title 标题 channel 文章栏目 commentNum 评论数 Image 导读图 }}} === 2.6 [=#point206 SendCommentWihSerialId ] === {{{ 发布评论需要什么参数 方式post 　　请求参数 　　comment 评论内容 　　serialId 车系id 　　evaluate 评价（好评差评） 　　token 通行证token 　　 　　返回： 　　{ 　　 resultCode:0 　　 resultMessage:"评论主题id不存在" 　　} 　　resultCode 结果代码，0表示成功 　　resultMessage 显示提示信息 }}} === 2.7 [=#point207 getPhotoBySerialId ] === {{{ 方式get 请求参数: 　　serialId 车系id 　　Num 图片张数 返回： { data:[ { typeId:"1" name:"外观" photos:[ { smallPhoto:"http://", bigPhoto:"http://" }, { smallPhoto:"http://", bigPhoto:"http://" } ] }, { typeId:"2" name:"内饰" photos:[ { smallPhoto:"http://", bigPhoto:"http://" }, { smallPhoto:"http://", bigPhoto:"http://" } ] } ] } typeId 对应“外观”，“内饰”等分类 name 分类名称 photos（最多返回6组图片） smallPhoto 列表显示用小图 bigPhoto 图片客户端显示用大图 }}} === 2.8 [=#point208 getPhotoBySerialIdTypeId ] === {{{ 请求方式get 请求参数: serialId 车系id typeId 图片类型id，对应外观，内饰等 { photos:[ { smallPhoto:"http://", bigPhoto:"http://" }, { smallPhoto:"http://", bigPhoto:"http://" } ] } smallPhoto 列表显示用小图 bigPhoto 图片客户端显示用大图 }}} === 2.9 [=#point209 口碑 ] === {{{ 口碑html：mrobot提供页面链接，客户端通过webview调用 客户端提供productID: 类型id 添加“我要点评”按钮：pcaction://postComment/{$productId} }}} === 2.10 [=#point210 车型终端概述 ] === {{{ 概述html: mrobot提供页面链接，客户端通过webview调用 客户端提供modelId: 类型id 添加“进入论坛”按钮，链接：pcaction://bbs-topics/{$bbsId} }}} === 2.11 [=#point211 车型终端参数 ] === {{{ 参数html: mrobot提供页面链接，客户端通过webview调用 客户端提供modelId: 类型id }}} === 2.12 [=#point212 车型终端经销商] === {{{ 经销商html: mrobot提供页面链接，客户端通过webview调用 客户端提供modelId: 类型id 添加地区选择按钮，按钮行为参考 http://mrobot.pcauto.com.cn/v2/price/models/20073 }}} === 2.13 [=#point213 车型对比结果 ] === {{{ mrobot提供页面链接，客户端通过webview调用 客户端提供id1和id2：是需要对比的两个产品 hideSameParams：真为true，假为false；真则隐藏相同的参数，否则显示所有参数。 }}} === 2.14 [=#point214 购车计算器 ] === {{{ mrobot提供页面链接，客户端通过webview调用 客户端提供modelId: 类型id 备注：参考http://price.pcauto.com.cn/vbuycar.jsp ，各项参数以选择框作为选择组件。\ }}} === 3 [=#point300 配合的接口(车型库接口及编辑出的接口) ] === 此部分的接口由车型库和编辑的同事配合 === 3.1 [=#point301 通过品牌ID得到车系列表 ] === {{{ 　　请求方式get 　　请求参数: 　　brandId 品牌Id 　　 　　返回： 　　{ 　　 "manufacturers":[ 　　 { 　　 "brandName":"奥迪", 　　 "name":"一汽奥迪", 　　 "serials":[ 　　 { 　　 "id":"1", 　　 "name":"奥迪A5", 　　 "kind":"suv", 　　 "priceRange":"37.28~56.7", 　　 "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg", 　　 "count":85 　　 }, 　　 { 　　 "id":"1", 　　 "name":"奥迪A6L", 　　 "kind":"suv", 　　 "priceRange":"37.28~56.7", 　　 "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg", 　　 "count":85 　　 } 　　 ] 　　 }, 　　 { 　　 "brandName":"奥迪", 　　 "name":"进口奥迪", 　　 "serials":[ 　　 { 　　 "id":"1", 　　 "name":"奥迪A5", 　　 "kind":"suv", 　　 "priceRange":"37.28~56.7", 　　 "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg", 　　 "count":85 　　 } 　　 ] 　　 } 　　 ] 　　} 　　备注： 　　name 厂家名称 　　 id 车系id 　　 name 车系名称 　　 kind级别 　　 priceRange指导价 　　 photo 图片 　　count: 返回的车型的数量 　　原型页面： 　　 http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/03_explain_brand.html#nowjibie=1&duibix=0&CSUM=1 }}} === 3.2 [=#point302 通过车系ID得到车型列表 ] === {{{ 　　请求方式get 　　请求参数: 　　SerialId 车系id 　　返回： 　　{ 　　 "brandId":356, 　　 "serialGroupName":"奥迪Q5", 　　 "bbsId":"16856", 　　 "photo":"http: //XXXXX", 　　 "kind":"SUV", 　　 "priceRange":"123~125万", 　　 "modelTotal":"5", 　　 "advantage":"好啊好", 　　 "disadvatage":"衰啊衰", 　　 "data":[ 　　 { 　　 "id":"19082", 　　 "title":"奥迪进取型", 　　 "price":"1-5", 　　 "status":"在售" 　　 }, 　　 { 　　 "id":"19083", 　　 "title":"奥迪技术型", 　　 "price":"1-3", 　　 "status":"停产" 　　 } 　　 ] 　　} 　　备注： 　　brandId：品牌ID 　　bbsId 对应论坛id 　　photo 图片链接 　　kind 级别 　　priceRange官方报价 　　modelTotal 车型总数 　　advantage 优点 　　disadvatage 缺点 　　id 车型id 　　title 车型名称 　　price 报价 　　status 在售 停产等 　　原型页面： 　　http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/05_explain_cars.html#nowjibie=1&duibix=0&chexiback=pinpai&chexingback=chexi&CSUM=1 }}} === 3.3 [=#point303 通过价格返回车系列表（按首字母顺序排） ] === {{{ 　　请求方式get 　　请求参数: 　　priceRange :价格范围 例如“5-8万”，“8-10万”、 　　 　　返回： 　　{ 　　 "data": [ 　　 { 　　 "manufacturerName": "奥迪", 　　 "letter": "A", 　　 "photo": "http://XXXX", 　　 "serials": [ 　　 { 　　 "id": "1", 　　 "name": "奥迪A5", 　　 "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" 　　 }, 　　 { 　　 "id": "1", 　　 "name": "奥迪A6L", 　　 "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" 　　 } 　　 ] 　　 }, 　　 { 　　 "manufacturerName": "阿斯顿马丁", 　　 "letter": "A", 　　 "photo": "http://XXXX", 　　 "serials": [ 　　 { 　　 "id": "1", 　　 "name": "奥迪A5", 　　 "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg" 　　 } 　　 ] 　　 } 　　 ] 　　} 　　备注： 　　manufacturerName：厂商名 　　Letter：索引字母 　　Photo：厂商logo 　　Serials: 车系列表 　　Id:车型id 　　Name：车型名称 　　Photo：车型logo 网页版页面： 　　http://price.pcauto.com.cn/price/q-p2.html 原型页面： http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/04_explain_price.html#nowjibie=1&duibix=0&CSUM=1 }}} === 3.4 [=#point304 通过车系ID得到相关文章 ] === {{{ 请求参数: serialId 车系id pageNum 默认0，第几页 pageCount 默认0，每页多少篇文章，0则返回所有相关文章 返回： 　　{ 　　 "count":20, 　　 "pageNo":1, 　　 "pageSize":20, 　　 "data":[ 　　 { 　　 "id":"123", 　　 "title":"新车", 　　 "channel":"新闻", 　　 "commentNum":"12", 　　 "image":"http://xxdxx.jpg" 　　 }, 　　 { 　　 "id":"123", 　　 "title":"新车", 　　 "channel":"新闻", 　　 "commentNum":"12", 　　 "image":"http://xxdxx.jpg" 　　 } 　　 ] 　　} 　　备注： 　　id 文章id 　　title 标题 　　channel 文章栏目 　　commentNum 评论数 　　Image 导读图 　　网页版页面：http://price.pcauto.com.cn/sg3746/comment.html 　　原型页面: 　　http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/05_explain_cars.html#nowjibie=1&duibix=0&chexiback=pinpai&CSUM=1 }}} === 3.5 [=#point305 发表车系评论 ] === {{{ 　　请求参数 content评论内容 serialId 车系id evaluate 评价（好评差评） 1 好评 -1 差评 　　common_session_id 太平洋通行证,若为空则表示匿名评论 　　返回： 　　{ 　　 "resultCode":0, 　　 "resultMessage":"评论主题id不存在" 　　} resultCode 结果代码，0表示成功 -1表示失败 resultMessage 显示提示信息 　　网页版页面：http://price.pcauto.com.cn/sg3746/comment.html 　　原型页面: 　　http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/15_explain_score.html#nowjibie=1&duibix=0&chexiback=pinpai&chexingback=chexi&CSUM=1 }}} === 3.6 [=#point306 口碑 ] === {{{ 　　请求参数： 　　productId: 对应的汽车id 　　返回结果： 　　{ 　　 "score": { 　　 "facade": 8.3, 　　 "interior ": 8.3, 　　 "control": 8.3, 　　 "safe": 8.3, 　　 "fuelConsump": 6.5, 　　 "afterSales": 6.5, 　　 "totalScore": 8.2, 　　 "scoreMemberhip": 5000 　　 }, 　　 "recommand": { 　　 "yes": 2009, 　　 "no": 747, 　　 "purchaseSuggest": 73 　　 }, 　　 "comment": [ 　　 { 　　 "username": "中国人", 　　 "date": "2012-05-23 22:38:12", 　　 "content": "我买了一台11.5万的白配黑。啥都行。跑的起来。就是油耗好像不是说的那么低啊，市内要到10升了。高速也要8升。是我开的不好嘛。" 　　 }, 　　 { 　　 "username": "中国人", 　　 "date": "2012-05-23 22:38:12", 　　 "content": "我买了一台11.5万的白配黑。啥都行。跑的起来。就是油耗好像不是说的那么低啊，市内要到10升了。高速也要8升。是我开的不好嘛。" 　　 } 　　 ] 　　} 　　备注： 　　score : 评分模块 　　facade : 外观平均分 　　interior : 内饰平均分 　　control : 操控平均分 　　safe : 安全平均分 　　fuelConsump: 油耗平均分 　　afterSales: 售后平均分 　　totalScore: 网友平均分 　　scoreMemberhip : 打分人数 　　recommand : 推荐模块 　　yes : 推荐人数 　　no : 不推荐人数 　　purchaseSuggest : 推荐购买人数的百分比 　　comment : 评论模块 　　username : 用户名 　　date : 发表日期 　　content : 评论内容 　　 　　网页版页面：http://price.pcauto.com.cn/sg3746/comment.html 　　原型页面: http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/05_explain_cars.html#nowjibie=1&duibix=0&chexiback=pinpai&CSUM=1 }}} === 3.7 [=#point307 购车计算器 ] === {{{ 　　请求参数： 　　modelId: 汽车产品id 　　返回结果： 　　与原型一致的HTML页面，其中下拉的三角与跟网页版的一致，可以是下拉框或单选框。 　　 　　 　　备注： 　　原型页面: 　　http://trac.pc.com.cn/mobile/pototype/ideas/auto_product/v1.0.8/13_explain_calculator_detailed.html#nowjibie=1&duibix=0&CSUM=1 网页版页面： http://price.pcauto.com.cn/vbuycar.jsp }}} == 4. [=#point400 测试环境接口配置 ] == 改HOST的指向戴裕文的机器 192.168.23.101 mrobot.pconline.com.cn == 5. [=#point500 修改历史 ] == 2012-08-02: -接口第一版