pcauto_chexingku/web-intf – iphone

Context Navigation

Version 13 (modified by daiyuwen, 14 years ago) (diff)
--

车型库项目接口

1. 开发时间，负责人及进度汇报

批次	页面	涉及MROBOT接口	是否需要 HTML切图	需配合的接口负责人及进度	接口开发预计时间	接口进度（百分比）	接口实际完成时间	接口确认
第一批	品牌列表页(首页)	以前的接口	-	-	-	-	-	-
第一批	价格列表页(首页)	2.4 getSerialListByPrice 2.3 getPriceList	-	3.3 通过价格返回车系列表（按首字母顺序排）	8/3	80% （缺配合的接口，目前数据为假数据）	接口实际完成时间	接口确认
第一批	首页搜索状态	-	-	-	-	-	-	-
第一批	品牌内页	2.1 getSerialListByBrandId	-	3.1 通过品牌ID得到车系列表	8/3	80% （缺配合的接口，目前数据为假数据）	接口实际完成时间	接口确认
第二批	车系终端（概述）	2.2 getModelListBySerialId	-	3.2 通过车系ID得到车型列表	8/5	0%	接口实际完成时间	接口确认
第二批	车系终端（文章）	2.5 getArticleListBySerialId	是	3.4 通过车系ID得到相关文章	8/5	0%	接口实际完成时间	接口确认
第二批	车系终端（口碑）	2.9 口碑	是	3.6 口碑	8/7	0%	接口实际完成时间	接口确认
第二批	车系终端（图片）	2.7 getPhotoBySerialId	-	以前的接口	8/7	0%	接口实际完成时间	接口确认
第二批	车型终端（概述）	2.10 车型终端概述	是	以前的接口	8/9	0%	接口实际完成时间	接口确认
第二批	车型终端（参数）	2.11 车型终端参数	是	以前的接口	8/9	0%	接口实际完成时间	接口确认
第二批	车型终端（经销商）	2.12 车型终端经销商	是	以前的接口	8/11	0%	接口实际完成时间	接口确认
第二批	收藏夹（车型）	-	-	-	-	-	-	-
第二批	收藏夹（车系）	-	-	-	-	-	-	-
第三批	图片列表	2.8 getPhotoBySerialIdTypeId	-	以前的接口	8/11	0%	接口实际完成时间	接口确认
第三批	图片终端	-	-	-	-	-	-	-
第三批	搜索页	-	-	-	-	-	-	-
第三批	搜索条件	-	-	-	-	-	-	-
第三批	搜索结果	-	-	-	-	-	-	-
第三批	对比结果	2.13 车型对比结果	是	以前的接口	8/14	0%	接口实际完成时间	接口确认
第三批	计算器详细页	2.14 购车计算器	是	3.7 购车计算器	8/14	0%	接口实际完成时间	接口确认
第三批	城市选择页	-	-	-	-	-	-	-
第三批	评分页	2.6 SendCommentWihSerialId	-	3.5 发表车系评论	8/16	0%	接口实际完成时间	接口确认

2. mrobot的接口

mrobot自身的接口，由客户端调用

2.1 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 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 getPriceList

请求方式:get
请求参数:无
Url:
   http://mrobot.pcauto.com.cn/v3/price/getPriceList
返回：
{
    "data":[
        {
            "title":"5万以下",
            "indexId":0
        },
        {
            "title":"5-8万",
            "indexId":1
        },
        {
            "title":"8-10万",
            "indexId":2
        },
        {
            "title":"10-15万",
            "indexId":3
        },
        {
            "title":"15-20万",
            "indexId":4
        },
        {
            "title":"20-25万",
            "indexId":5
        },
        {
            "title":"25-35万",
            "indexId":6
        },
        {
            "title":"35-50万",
            "indexId":7
        },
        {
            "title":"50-70万",
            "indexId":8
        },
        {
            "title":"70-100万",
            "indexId":9
        },
        {
            "title":"100-150万",
            "indexId":10
        },
        {
            "title":"150万以上",
            "indexId":11
        }
    ]
}

indexId 价格范围索引
title 价格范围内容

2.4 getSerialListByPrice

请求方式get
请求参数:
　　price :价格范围，例如 100-150万  70-100万 ，需要UTF-8编码
Url:
   http://mrobot.pcauto.com.cn/v3/price/getSerialListByPrice
例子：
   http://mrobot.pcauto.com.cn/v3/price/getSerialListByPrice?price=70-100%e4%b8%87

返回：
{
    "data":[
        {
            "manufacturerName":"奥迪",
            "letter":"A",
            "photo":"http://img2.pcauto.com.cn/pcauto/1011/29/1328170_audi.png",
            "serials":[
                {
                    "id":"8",
                    "name":"奥迪TT",
                    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg"
                },
                {
                    "id":"3975",
                    "name":"奥迪Q3",
                    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg"
                }
            ]
        },
        {
            "manufacturerName":"宝马",
            "letter":"B",
            "photo":"http://img3.pcauto.com.cn/pcauto/1011/29/1328238_bmw_1.png",
            "serials":[
                {
                    "id":"424",
                    "name":"宝马3系",
                    "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 通过品牌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 通过车系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 通过价格返回车系列表（按首字母顺序排）

　　请求方式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 通过车系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 发表车系评论

　　请求参数
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 口碑

　　请求参数：
　　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 购车计算器

　　请求参数：
　　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. 测试环境接口配置

改HOST的指向戴裕文的机器 192.168.23.101 mrobot.pconline.com.cn

5. 修改历史

2012-08-02:

-接口第一版

Download in other formats:

Plain Text

Context Navigation

车型库项目接口

目录

1. 开发时间，负责人及进度汇报

2. mrobot的接口

2.1 getSerialListByBrandId

2.2 getModelListBySerialId

2.3 getPriceList

2.4 getSerialListByPrice

2.5 getArticleListBySerialId

2.6 SendCommentWihSerialId?

2.7 getPhotoBySerialId

2.8 getPhotoBySerialIdTypeId

2.9 口碑

2.10 车型终端概述

2.11 车型终端参数

2.12 车型终端经销商

2.13 车型对比结果

2.14 购车计算器

3 配合的接口(车型库接口及编辑出的接口)

3.1 通过品牌ID得到车系列表

3.2 通过车系ID得到车型列表

3.3 通过价格返回车系列表（按首字母顺序排）

3.4 通过车系ID得到相关文章

3.5 发表车系评论

3.6 口碑

3.7 购车计算器

4. 测试环境接口配置

5. 修改历史

Download in other formats: