== 车型库项目接口 ==

=== 目录 ===
 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 产品终端页网上比价 ]

 3.2 [#point302 产品资讯接口 ]

 3.3 [#point303 某产品类型的品牌列表 ]

 3.4 [#point304 产品发送评论  ]

 3.5 [#point305 显示分类排名前三的品牌 ]

 3.6 [#point306 产品搜索热点推荐（编辑出） ]

 3.7 [#point307 推荐品牌（编辑出） ]


 4. [#point400 测试环境接口配置  ]

 5. [#point500 修改历史 ]

== 1. [=#point100 开发时间，负责人及进度汇报 ]==

||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||=接口进度（百分比）=||=接口实际[[BR]]完成时间=||=接口确认=||
||第一批|| 产品库首页 || 2.14 [#point214 产品首页 ] ||- || 3.5 [#point305 显示分类排名前三的品牌名字] [[BR]]郑华聪 袁火青 ||  8/2 || 0% || 接口实际完成时间 || 接口确认  
||第一批|| 品牌列表 ||  2.7 [#point207 某产品类型的品牌列表 ] [[BR]]2.12 [#point212 搜索产品（产品结果列表）] ||- || 3.3 [#point302 某产品类型的品牌列表] [[BR]] 3.7 [#point307 推荐品牌（编辑出）][[BR]]郑华聪    袁火青 ||  8/2 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 产品列表 || 2.8 [#point208 产品列表 ] ||- || -  ||  8/2 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 概述(对比浮层) || 2.3 [#point203 产品终端页概述 ] ||是 || -  ||  8/3 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 参数 || 2.4 [#point204 产品终端页参数 ] ||是 || -  ||  8/3 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 报价 || 2.1 [#point201 产品终端页报价 ] ||是 || -  ||  8/6 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 图片(图片列表/展示) ||  以前的接口 ||  - || - || - || -|| - || -  
||第二批|| 资讯(文章页) || 2.6 [#point206 请求产品资讯 ] ||是 || 3.2 [#point302 产品资讯接口] [[BR]]郑华聪    袁火青  ||  8/6 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 点评(我要点评) || 2.9 [#point209 产品点评界面 ] ||是|| -  ||  8/6 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 网上比价 || 2.2 [#point202 产品终端页网上比价 ] ||是 || 3.1 [#point301 产品终端页网上比价][[BR]] 黄忠 ||  8/6 || 0% || 接口实际完成时间 || 接口确认  
||第二批|| 选择城市 ||  以前的接口 ||  - || - || - || -|| - || -  
||第三批|| 对比结果 || 2.5 [#point205 产品对比页 ] ||是 || -  ||  8/7 || 0% || 接口实际完成时间 || 接口确认  
||第三批|| 选机2页面 || 以前的接口 ||  - || - || - || -|| - || -  
||第三批|| 搜索页2页面 ||  2.11[#point211 搜索产品（品牌分类统计） ]  ||- || -  ||  8/7 || 0% || 接口实际完成时间 || 接口确认  
||第四批|| 发送评论[[BR]]（戴裕文补充） ||2.10[#point210 产品发送评论 ]  || - || 3.4 [#point304 产品发送评论][[BR]]郑华聪    袁火青 ||  8/8 || 0% || 接口实际完成时间 || 接口确认  
||第四批|| 产品搜索热点推荐[[BR]]（戴裕文补充） ||2.13[#point213 产品搜索热点推荐 ]  || - || 3.6 [#point306 产品搜索热点推荐(编辑出)][[BR]] 郑华聪    袁火青  ||  8/8|| 0% || 接口实际完成时间 || 接口确认  



  
==  2. [=#point200 mrobot的接口 ] ==
mrobot自身的接口，由客户端调用


===  2.1 [=#point201 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 [=#point202 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 [=#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 产品终端页网上比价 ] ===
{{{

    HTTP请求方式：get
    请求参数：
           productID: 产品id
    返回参数:
　　	[{
　　	    storeName:"卓越",
　　	    price:"2499.0",
　　	    shippingRate:"购物满29元免运费",
　　	    buyLink:"http://XXXX"
　　	},{
　　	    storeName:"卓越",
　　	    price:"2499.0",
　　	    shippingRate:"购物满29元免运费",
　　	    buyLink:"http://XXXX"
　　	}]
   备注：
        商城名称：storeName
       报价：price
       运费：shippingRate
       购买：buyLink
　　网页版类似页面：http://product.pconline.com.cn/pdlib/pk/price410030.html
　　效果图：
　　
}}}


=== 3.2 [=#point302 产品资讯接口 ] ===
{{{

    HTTP请求方式：get
    请求参数：
        productId：产品id 
    　 pageNo:第几页
    　　pageSize:分页数

    返回参数
        {
            "productId":1021,
            "total":20,
            "articleList":[
                {
                    "id ":1234,
                    "title":"苦逼0",
                    "channel":"评测",
                    "image":"http://xxdxx.jpg"
                },
                {
                    "id ":1234,
                    "title":"苦逼0",
                    "channel":"导购",
                    "image":"http://xxdxx.jpg"
                }
            ]
        }

    备注：
        id 文章id
       title 标题
        channel 文章栏目,"评测"还是“行情”
        image 导读图
    网页版类似页面：product.pconline.com.cn/mobile/nokia/410030_review.html
　　效果图：


}}}

=== 3.3 [=#point303 某产品类型的品牌列表 ] ===
{{{

		HTTP请求方式：get
		请求参数：
		typeID: 产品类型id，例如手机20937
	    
	返回参数：
　　{
　　    "typeId": 20937,
　　    "totalBrands": {
　　        "total": 20,
　　        "sections": [
　　            {
　　                "brands": [
　　                    {
　　                        "id": 693,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png",
　　                        "letter": "A",
　　                        "name": "APPLE"
　　                    },
　　                    {
　　                        "id": 693,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png",
　　                        "letter": "A",
　　                        "name": "A"
　　                    }
　　                ],
　　                "index": "A",
　　                "rowNum": 3
　　            },
　　            {
　　                "brands": [
　　                    {
　　                        "id": 723,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png",
　　                        "letter": "B",
　　                        "name": "B品牌1"
　　                    },
　　                    {
　　                        "id": 723,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png",
　　                        "letter": "B",
　　                        "name": "B品牌2"
　　                    }
　　                ],
　　                "index": "B",
　　                "rowNum": 15
　　            }
　　        ]
　　    }
　　}


　　typeId :产品类型id，例如手机20937	
	total：版块集合内部元素的总数
	brands:版块内品牌集合
	id:品牌id
	logo:品牌logo图片url
	letter；品牌名称首字母
	name:品牌名称
	sections:品牌的总集合的分块，按字母A-Z顺序分
	index：分块所属的字母
	rowNum:分块内品牌数量
	
　　备注：
    网页版类似页面http://product.pconline.com.cn/notebook/

}}}

=== 3.4 [=#point304 产品发送评论 ] ===
{{{
HTTP请求方式：post
请求参数：
　　productId: 产品ID
　　score  :  分数 从1到5的整数
　　title  : 标题  
　　advantage  ：优点
　　deficiency   ：缺点
　　summary	    ：总结
　　common_session_Id    ：太平洋网络通行证的sessionId 若为空则匿名发评论
　　
返回参数：
　　{
　　stats:"ok",
　　msg:"发送成功"
　　}
　　
　　Stats发送状态，成功为ok，失败为error，
　　msg中显示提示的信息 ，例如必填字段未填，或者其他必要的提示等
　　
　　备注：
网页版类似页面http://product.pconline.com.cn/mobile/samsung/485270_comment.html#dianping

}}}

=== 3.5 [=#point305 显示分类排名前三的品牌 ] ===
{{{
	HTTP请求方式：get
	请求参数：
	typeId :产品类型ID，逗号分割,例如手机20937,台式机20806

	返回参数：
	{
		"20937":["三星","APPLE","HTC"],
		"256567":["三星","APPLE","HTC"],
		"256568":["三星","APPLE","HTC"]
	}
	备注：返回的顺序按照排名顺序来排
	排名顺序根据类似此报价页面的http://product.pconline.com.cn/notebook
}}}

=== 3.6 [=#point306 产品搜索热点推荐（编辑出） ] ===
{{{
    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：无

	返回参数：
	{
		"words":[
		    "三星","htc","苹果","华为"
		]
	}

　　备注：返回最多5个关键词
　　由编辑设置

}}}


=== 3.7 [=#point307 推荐品牌（编辑出） ] ===
{{{
    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：无

	返回参数：
　　{
　　	"total": 2,
　　	"25289": [{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	},
　　	{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	}],
　　	"25293": [{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	},
　　	{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	}]
　　
　　}
　　备注：返回编辑推荐的品牌
　　此关键词为编辑设置
　　
	total：版块集合内部元素的总数
	25289,25293类似的数字，产品类型
	id:品牌id
	logo:品牌logo图片url
　　name:品牌名称

}}}


== 5. [=#point500 修改历史 ] ==

2012-08-02:
    -接口第一版