pcauto_chexingku/web-intf – iphone

Context Navigation

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

车型库项目接口

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

    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 产品资讯接口

    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 某产品类型的品牌列表

		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 产品发送评论

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 显示分类排名前三的品牌

	HTTP请求方式：get
	请求参数：
	typeId :产品类型ID，逗号分割,例如手机20937,台式机20806

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

3.6 产品搜索热点推荐（编辑出）

    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：无

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

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

3.7 推荐品牌（编辑出）

    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. 修改历史

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

3.2 产品资讯接口

3.3 某产品类型的品牌列表

3.4 产品发送评论

3.5 显示分类排名前三的品牌

3.6 产品搜索热点推荐（编辑出）

3.7 推荐品牌（编辑出）

5. 修改历史

Download in other formats: