| Version 3 (modified by daiyuwen, 14 years ago) (diff) |
|---|
车型库项目接口
目录
2.3 getPriceList
2.9 口碑
2.10 车型终端概述
2.11 车型终端参数
2.12 车型终端经销商
2.13 车型对比结果
2.14 购车计算器
3.1 通过品牌ID得到车系列表
3.2 通过车系ID得到车型列表
3.4 通过车系ID得到相关文章
3.5 发表车系评论
3.6 口碑
3.7 购车计算器
1. 开发时间,负责人及进度汇报
| 批次 | 页面 | 涉及MROBOT接口 | 是否需要 HTML切图 | 需配合的接口负责人 及进度 | 接口开发 预计时间 | 接口进度(百分比) | 接口实际 完成时间 | 接口确认 |
|---|---|---|---|---|---|---|---|---|
| 第一批 | 产品库首页 | 2.14 产品首页 | - | 3.5 显示分类排名前三的品牌名字 郑华聪 袁火青 | 8/2 | 0% | 接口实际完成时间 | 接口确认 |
| 第一批 | 品牌列表 | 2.7 某产品类型的品牌列表 2.12 搜索产品(产品结果列表) | - | 3.3 某产品类型的品牌列表 3.7 推荐品牌(编辑出) 郑华聪 袁火青 | 8/2 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 产品列表 | 2.8 产品列表 | - | - | 8/2 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 概述(对比浮层) | 2.3 产品终端页概述 | 是 | - | 8/3 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 参数 | 2.4 产品终端页参数 | 是 | - | 8/3 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 报价 | 2.1 产品终端页报价 | 是 | - | 8/6 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 图片(图片列表/展示) | 以前的接口 | - | - | - | - | - | - |
| 第二批 | 资讯(文章页) | 2.6 请求产品资讯 | 是 | 3.2 产品资讯接口 郑华聪 袁火青 | 8/6 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 点评(我要点评) | 2.9 产品点评界面 | 是 | - | 8/6 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 网上比价 | 2.2 产品终端页网上比价 | 是 | 3.1 产品终端页网上比价 黄忠 | 8/6 | 0% | 接口实际完成时间 | 接口确认 |
| 第二批 | 选择城市 | 以前的接口 | - | - | - | - | - | - |
| 第三批 | 对比结果 | 2.5 产品对比页 | 是 | - | 8/7 | 0% | 接口实际完成时间 | 接口确认 |
| 第三批 | 选机2页面 | 以前的接口 | - | - | - | - | - | - |
| 第三批 | 搜索页2页面 | 2.11搜索产品(品牌分类统计) | - | - | 8/7 | 0% | 接口实际完成时间 | 接口确认 |
| 第四批 | 发送评论 (戴裕文补充) | 2.10产品发送评论 | - | 3.4 产品发送评论 郑华聪 袁火青 | 8/8 | 0% | 接口实际完成时间 | 接口确认 |
| 第四批 | 产品搜索热点推荐 (戴裕文补充) | 2.13产品搜索热点推荐 | - | 3.6 产品搜索热点推荐(编辑出) 郑华聪 袁火青 | 8/8 | 0% | 接口实际完成时间 | 接口确认 |
2. mrobot的接口
mrobot自身的接口,由客户端调用
2.1 getSerialListByBrandId
请求方式get
请求参数:
brandId 品牌Id
返回:
{
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 getModelListBySerialId
请求方式get
请求参数:
SerialId 车系id
返回:
{
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:"停产"
}
]
}
bbsId 对应论坛id
photo 图片链接
kind 级别
priceRange官方报价
modelTotal 车型总数
ceditNumber 贷款电话
advantage 优点
disadvatage 缺点
id 车型id
title 车型名称
price 报价
status 在售 停产等
2.3 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 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 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 SendCommentWihSerialId?
发布评论需要什么参数
方式post
请求参数
comment 评论内容
serialId 车系id
evaluate 评价(好评差评)
token 通行证token
返回:
{
resultCode:0
resultMessage:"评论主题id不存在"
}
resultCode 结果代码,0表示成功
resultMessage 显示提示信息
2.7 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 getPhotoBySerialIdTypeId
请求方式get
请求参数:
serialId 车系id
typeId 图片类型id,对应外观,内饰等
{
photos:[
{
smallPhoto:"http://",
bigPhoto:"http://"
},
{
smallPhoto:"http://",
bigPhoto:"http://"
}
]
}
smallPhoto 列表显示用小图
bigPhoto 图片客户端显示用大图
2.9 口碑
口碑html:mrobot提供页面链接,客户端通过webview调用
客户端提供productID: 类型id
添加“我要点评”按钮:pcaction://postComment/{$productId}
2.10 车型终端概述
概述html: mrobot提供页面链接,客户端通过webview调用
客户端提供modelId: 类型id
添加“进入论坛”按钮,链接:pcaction://bbs-topics/{$bbsId}
2.11 车型终端参数
参数html: mrobot提供页面链接,客户端通过webview调用 客户端提供modelId: 类型id
2.12 车型终端经销商
经销商html: mrobot提供页面链接,客户端通过webview调用 客户端提供modelId: 类型id 添加地区选择按钮,按钮行为参考 http://mrobot.pcauto.com.cn/v2/price/models/20073
2.13 车型对比结果
mrobot提供页面链接,客户端通过webview调用 客户端提供id1和id2:是需要对比的两个产品 hideSameParams:真为true,假为false;真则隐藏相同的参数,否则显示所有参数。
2.14 购车计算器
mrobot提供页面链接,客户端通过webview调用 客户端提供modelId: 类型id 备注:参考http://price.pcauto.com.cn/vbuycar.jsp ,各项参数以选择框作为选择组件。\
3 配合的接口(车型库接口及编辑出的接口)
此部分的接口由车型库和编辑的同事配合
3.1 产品终端页网上比价
3.1 通过品牌ID得到车系列表
3.2 通过车系ID得到车型列表
3.3 通过价格返回车系列表(按首字母顺序排)
3.4 通过车系ID得到相关文章
3.5 发表车系评论
3.6 口碑
3.7 购车计算器
5. 修改历史
2012-08-02:
-接口第一版
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)