wiki:pcauto_BuyAuto_1.0.0

Version 143 (modified by limingjiu, 12 years ago) (diff)

--

接口文档

Table of Contents

  1. 接口文档
    1. 2.0 辅助接口
      1. 2.0.1.城市切换(已有接口)
      2. 2.0.2. 获取当前用户的可团购车系列表
    2. 2.1 车型库
      1. 2.1.1.车型库-品牌列表
      2. 2.1.2.车型库-品牌-车系列表
      3. 2.1.3.车型库->车系->车型列表
      4. 2.1.4.车型库-热销排行榜
      5. 2.1.4.车型库-搜索-关键词
      6. 2.1.5 车型库-车系搜索
      7. 2.1.6 车型库-根据车型id查询车型详细
    3. 2.2 车系
      1. 2.2.1.车系-综述
      2. 2.2.2.车系-优惠
      3. 2.2.3.车系-参配
      4. 2.2.4.车系-点评
      5. 2.2.5.车系-资讯列表
      6. 2.2.6.车系-资讯文章
    4. 2.3 车型
      1. 2.3.1.车型-综述
      2. 2.3.2.车型-参配
      3. 2.3.3.车型-点评(资讯客户端的车主点评)
      4. 2.3.4.车型-团购/陪购
      5. 2.3.5.车型-优惠详情
    5. 2.4 找车
      1. 2.4.1. 筛选-精准选车条件
      2. 2.4.2. 筛选-快速查找符合条件个数/列表
    6. 2.5 优惠
      1. 2.5.1. 优惠-优惠列表
      2. 2.5.2. 优惠-详细
      3. 2.5.3. 推荐经销商
    7. 2.6 团购
      1. 2.6.1. 团购-团购列表(含筛选)
      2. 2.6.3. 团购-活动详细
      3. 2.6.3. 团购报名接口信息
      4. 2.6.4. 三人行报名接口 (发起团购的接口)
      5. 2.6.5. 团购投诉接口信息
      6. 2.6.5. 获取车系/车型最近30天4S店报名人数
    8. 2.7 我的
      1. 2.7.1. 我的-订阅列表
      2. 2.7.2. 我的-添加车型/车系订阅
      3. 2.7.3. 我的-团购列表
      4. 2.7.4. 我的-陪购列表
      5. 2.7.4. 我的-消息推送定制
      6. 2.7.5. 我的-车库数据启动同步接口
      7. 2.7.8 根据车系/车型获取行情接口
    9. 2.8 工具
      1. 2.8.1. 购车计算器/车险计算器
    10. 2.9 图集
      1. 2.9.1. 车系/车型图片筛选条件(已有接口)
      2. 2.9.2. 车系/车型图片筛选查询(已有接口)
      3. 2.9.3. 车系/车型 全部图片查询(不用开发,等待下一版本设计)

2.0 辅助接口

2.0.1.城市切换(已有接口)

获取可切换的城市列表

2.0.2. 获取当前用户的可团购车系列表

请使用:  http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.6.1.团购-团购列表含筛选

2.1 车型库

2.1.1.车型库-品牌列表

备注:获取车型库品牌列表
Mrobot请求URL: http://mrobot.pcauto.com.cn/v2/price/brands
请求后端URL: http://price.pcauto.com.cn/interface/iphone/brand_list.jsp,
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1天
请求参数:无

2.1.2.车型库-品牌-车系列表

备注:通过品牌ID得到车系列表
Mrobot请求URL: http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/1?type=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:

参数名类型必须说明
bidnumberYES品牌id

返回参数,需要增加一个字段:

{
"manufacturers":[
 {
 "brandName":"奥迪",
 "name":"一汽奥迪",
 "brandIntroduction":"http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html",
 "serials":[
  {
   "id":3524,
   "name":"奥迪A4L",
   "kind":"中型车",
   "priceRange":"27.28~57.81 万",
   "isNew":0,
   "sellStatus":3,
   "photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
   "count":41
  },...]
}...]
}

2.1.3.车型库->车系->车型列表

备注:通过车系ID得到车型列表
请求URL: http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:

参数名类型必须说明
bidnumberYES品牌id

返回参数,需要增加一个字段:

2.1.4.车型库-热销排行榜

备注:
Mrobot正式URL : http://mrobot.pcauto.com.cn/buy/price/hotSellSerials/1?pageNo=1&pageSize=20
请求后端URL(开发): http://v17.pcauto.com.cn:8002/interface/iphone/praiselist_by_kindId.jsp?kindId=1&pageNo=1&pageSize=10
请求后端URL(线上): http://price.pcauto.com.cn/interface/iphone/praiselist_by_kindId.jsp?kindId=3&pageNo=1&pageSize=10
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
kindIdnumber1~8分别代表:紧凑型车、SUV、中型车、小型车、微型车、中大型车、豪华型车、MPV
pagenumber请求分页
pagesizenumber请求分页大小

返回参数

{
"total":146,
"list":[
{
"price":"12.38-16.08万",
"serialGroupId":"2734",
"serialGroupName":"卡罗拉",
"photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_2734.jpg"
},...]
}

2.1.4.车型库-搜索-关键词

备注:动态获取搜索关键字,由编辑在cms里维护
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/modelsForSearch
请求后端URL(线上): http://www.pcauto.com.cn/client/news/tghd/1409/intf4687.js
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
返回参数:

{
"modelList": [{
    "id": 123,
     "name": "蒙迪欧"
  }]
}

2.1.5 车型库-车系搜索

备注:
Mrobot请求URL: http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000
请求后端URL:  http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:

参数名类型必须说明
keywordstringYES查询条件
pageNonumberYES页码
pageSizenumberYES一页条数

2.1.6 车型库-根据车型id查询车型详细

备注:
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/modelMessage
请求后端URL(线上): http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=1&haveDealerPrice=0&haveBuyCarPrice=0&haveParameter=0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:

参数名类型必须说明
modelIdstringYES车型id
callbacknumberNO为解决js跨域问题,可不传


返回参数:

{
    id = 21804;									// 车型id
    kind = "\U4e2d\U578b\U8f66";				// 所属车系的车系类型(如紧凑型、xx型等)
    photo 	 = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/30/c19/30133161_1388384673038_120x90.jpg";	// 车型图片
    price 	 = "29.1";							// 车型价格
    serialId = 3524;							// 所属车系车系id
    serialName = "\U5965\U8feaA4L";				// 所属车系名称
    serialSubName = "\U4e00\U6c7d\U5965\U8fea";	// 所属车系的车系品牌(如:一汽大众、一汽奥迪、AC宝马)
    modelName 	= "2013\U6b3e 1.8 30TFSI \U81ea\U52a8\U8212\U9002\U578b";	// 车型名称
}

2.2 车系

2.2.1.车系-综述

备注: 请求URL:  http://mrobot.pcauto.com.cn/buy/price/serial/{id}?areaId={cityid}&isSubscribed={1、0}&modelIds={1,2,3} HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
seriesidstring车系id
isSubscribedstring是否已经订阅了车系,取值0、1
modelIdsstring本地已经加入对比的车型id列表,逗号隔开

2.2.2.车系-优惠

 http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.5优惠

2.2.3.车系-参配

备注: 请求URL:  http://mrobot.pcauto.com.cn/buy/price/serialDetail/{id}?subscributedIds=1,2,3
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
请求参数

参数名类型必须说明
idstring车系id
subscributedIdsstring本地已经加入订阅的车型id列表,如:1,2,3

2.2.4.车系-点评


备注:(资讯客户端的车主点评列表)获取某车系下的车主点评列表。接口为网页,点击网页中列表,跳转协议为:pcaction://pcauto-owner-review?modelId=${id}
请求URL: http://mrobot.pcauto.com.cn/buy/price/commentList/{serialId}
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无

 请求参数:
        serialId:车系id

2.2.5.车系-资讯列表

请求URL:  http://mrobot.pcauto.com.cn/buy/price/getArticlesBySerialId/{serialId}?pageNo=1&pageSize=20&type=0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
serialIdstring车系id
pagenumber分页页码
pagesizenumber分页大小
typenumber资讯类型:0、全部、1、评测 2、导购
返回参数
参数名类型必须说明
totalnumberyes资讯总个数
dataarrayyes资讯列表分页数据
列表项格式
参数名类型必须说明
idstring文章id
imagestring文章导读图
titlestring文章标题
channelNamestring栏目名
pubDatestring文章发布时间

2.2.6.车系-资讯文章

请求URL: http://mrobot.pcauto.com.cn/buy/cms/articles/{id}?size=18&picRule=2
HTTP请求方式:get
返回格式:html
请求参数

参数名类型必须说明
idstring文章id
sizenumber字体大小
picRulenumber图片模式
pageNonumber分页

2.3 车型

2.3.1.车型-综述

备注: 请求URL:  http://mrobot.pcauto.com.cn/buy/price/models/{id}?areaId=1&isCompared=0&isSubscribed=0
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
idstring车型id
areaIdstring城市id
isComparedstring是否本地已经添加对比,取值0、1
isSubscribedstring是否本地已经添加订阅,取值0、1
返回参数
参数名类型必须说明

页面内协议说明

协议串说明

2.3.2.车型-参配

请求URL:  http://mrobot.pcauto.com.cn/buy/price/modelDetail/{modelid}
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
modelidstring车型id
备注:
要做参配导航的情况下:配合如下接口请求参配导航的目录
http://mrobot.pcauto.com.cn/buy/price/modelDetail?fmt=json
然后当当点击某个目录后,调用js来让web导航:
js名称:
   setPosition(1)// 1为导航菜单的id

2.3.3.车型-点评(资讯客户端的车主点评)

备注:车主点评终端页
 请求URL:http://mrobot.pcauto.com.cn/buy/price/commentDetail/{modelId}?pageNo=1
 HTTP请求方式:get
 是否需要登录:否
 返回格式:html页面
 缓存方式:无
 缓存时间:无
 请求参数:
        modelId  车型id
        pageNo   当前分页

2.3.4.车型-团购/陪购

备注: 请求URL: 待定
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
modelidstring车系id
返回参数
参数名类型必须说明
----
页面内协议说明
参数名类型必须说明
----

2.3.5.车型-优惠详情

请使用:  http://trac.pc.com.cn/iphone/wiki/pcauto_BuyAuto_1.0.0#a2.5.2.优惠-详细

2.4 找车

2.4.1. 筛选-精准选车条件

备注:
Mrobot正式URL : http://mrobot.pcauto.com.cn/buy/price/chooseOption
后端请求测试URL: http://v17.pcauto.com.cn:8002/interface/iphone/price_choose_option.jsp
后端请求正式URL: http://price.pcauto.com.cn/interface/iphone/price_choose_option.jsp
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
返回参数说明:

1、级别-jb => 76-微型车(详细信息请参考接口数据)
2、排量-pl
3、变速箱-bsx
4、结构-mkid
5、国别-country
6、燃料-rl
7、座位-zw
8、驱动-qdfs
9、自定义价格  最低价-ps
10、自定义价格  最高价-pe

2.4.2. 筛选-快速查找符合条件个数/列表

备注:筛选条件变后,自动获取符合筛选条件的车型个数
1、用来请求找车首页的筛选条件
2、支持关联筛选,当用户的选择条件变更时,需要重新请求,请求的返回数据中:fact字段中,列出了每个筛选条件的可选值
3、list用来区分请求个数还是请求列表


Mrobot请求URL:  http://mrobot.pcauto.com.cn/buy/price/search?rid=1&list=true&jb=72&pageSize=20&pageNo=1
后端请求测试URL:  http://v17.pcauto.com.cn:8002/interface/iphone/query_car.jsp
后端请求正式URL:
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无

参数名类型必须说明
ridstring用户所在地区id
liststring筛选个数、筛选列表,取值true/false
psstring最小价格
pestring最大价格
jbstring级别
plstring排量
bsxstring变速箱
mkidstring结构
countrystring国别
rlstring燃料
zwstring座位
qdfsstring驱动
pzstring配置
pageNostring分页
pageSizestring分页大小

2.5 优惠

2.5.1. 优惠-优惠列表


Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/promotionList?areaId=1&pageSize=20&pageNo=1


后端请求正式环境URL:  http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp

后端请求环境URL:
 http://v17.pcauto.com.cn:8002/dealer/interface/app/market_groupby_model_json.jsp
HTTP请求方式:get
返回格式:json
请求参数

areaId:城市id [[BR]]
mfId: 厂商id [[BR]]
sgId: 车系id [[BR]]
modelId:车型id [[BR]]
pageNo:第几页 [[BR]]
pageSize:每页大小 [[BR]]
callback:js回调函数名称 [[BR]]

返回结果

{
 total: 143,			//团购总数
 pageCount: 15,		//团购总页数
 pageNo: 1,			//第几页
 pageSize: 10,		//每页大小
 models: [				//活动信息列表
  {
  modelId: 7616,			//车型id
  price: 7.78,			// 车型官方价
  name: "锐欧 2007款 1.4 手动 豪华型",	//车型名称
  discountPrice: 5.78,	//促销价
  discount : 20000,			//降幅
  dealers:[
   {
    dealerId : 32046,		// 经销商ID
    name : 庞大东风悦达起亚,	// 经销商简称 
    price : 7.78,			//车型官方价
    discountPrice: 5.78,	//行情促销价
    discount : 20000,			//降幅
    dealerPrice : 7.78,		// 经销商报价
    is4S : 1,		// 是否4S店,1:是,0:否
    is400 : 1,	// 是否400电话,1:是,0:否
    phone : 400-670-5680, 	//电话
    namelistRange : 1			// 销售范围,0:本市,1:本省,2:全国
  },
  ...
 ]
},
...
]
}

2.5.2. 优惠-详细

获取优惠详情数据
Web页面请求地址: http://mrobot.pcauto.com.cn/buy/price/promotionDetail/5529226?areaId=1&modelId=23885
请求参数:marketId 商家行情id

idstring优惠、行情id
areaIdstring城市id
modelIdstring车型id,如果没有,传0


返回数据格式:Html页面

后端请求地址:
测试:  http://dev3.pcauto.com.cn:8001/dealer/interface/app/dealer_market_json.jsp
正式:http://price.pcauto.com.cn:/dealer/interface/app/dealer_market_json.jsp
返回数据
{
“deadline”:”2014-04-30”, //截止日期
“isShow24Icon”:””, 		// 是否24小时营业, 1:是,0:否
“is400”:1,	// 是否400电话,1:是,0:否
“phone”:”123456” ,//电话
“discountInfo”:{
"dealerId": "2014.04.09-2014.04.30", 	// 经销商ID
     	"expiry": "2014.04.09-2014.04.30", 	//有效期
"shortInfo": "", 	//短标题
     	"info": "进口大众广州鸿众店内高尔夫(进口)现车充足,近期购车最高优惠10万。",
},
    "models": [
        {
"modelId": "高尔夫(进口) 2012款 1.4T 舒适敞篷版",
            "modelName": "高尔夫(进口) 2012款 1.4T 舒适敞篷版",
            "price": "34.98万", //官方价
            "nowPrice": "24.98万", //现价
            "discount": "10万", //降幅
            "quantity": "充足",		// 车型数量情况
"isReplace": "0",	//是否含旧车优惠,1:是,0:否
"decline": "",		// 行情优惠降幅
        },
        ......
],
addModels:[
{
"modelId": "" 		//加装车id
"modelName": "", 		//加装车名称
            "price": "", 		//加装车车型的官方价
            "addPrice": "", 		//加装车售价
            "config": "{addConfig: , otherConfig: }", 		//加装车配置
},
......
]
    "images": [
"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114292031_500.jpg",
"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/21/c1/21155361_1369114385703_270x202.jpg"
    ]
}

2.5.3. 推荐经销商

获取推荐经销商(公共询价报名页,web页面调用,app未使用到)
正式环境URL:(已上线)
http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp
测试环境URL:
http://dev3.pcauto.com.cn:8001/dealer/interface/order/recommend_dealer.jsp

HTTP请求方式:get
返回格式:json
请求参数
rid:城市ID【必填】
sgid:车系id【必填】
type: 名单类型(询价报名固定为0即可)【必填】
callback:回调函数

返回结果
[
    {
        "vip":-1,
        "dealerId":55342,
        "phone":"400-881-0693",
        "isShow24Icon":1,
        "areaName":"龙华新区",
        "range":0,
        "phoneType":1,
        "address":"龙华新区金龙路(梅林关口)上河坊购物乐园首层国汽名车广场",
        "name":"深圳国汽宝马",
        "agent":"4S店"
    }...
]

2.6 团购

2.6.1. 团购-团购列表(含筛选)

备注:
请求URL: 正式环境URL: http://mai.pcauto.com.cn/gct/interface/get_gct_activity_list.jsp?regionId=1
测试环境URL: http://v37.pcauto.com.cn:8080/gouchetuan/interface/get_gct_activity_list.jsp?regionId=1
Mrobot请求URL: http://mrobot.pcauto.com.cn/buy/price/activityList?regionId=1&pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数

参数名类型必须说明
serialIdsstring筛选条件,如果全部车型,则为空,多个车系的情况,以,号隔开
regionIdstring城市id
filterstringfilter=1,必填
provinceIdstring省份id
manufacturerIdstring厂商id
pagenumber请求分页
pagesizenumber请求分页大小

返回示例:

{
total: 143,	 //团购总数
pageCount: 15, //团购总页数
pageNo: 1,	 //第几页
pageSize: 10,	 //每页大小
data: [		 //活动信息列表
{
id: 4702,		 //团购活动id
person: 7,		 //参加团购活动人数
title: "别克厂家直销会 百万钜惠让利等你来", //团购活动标题
price: "17.5",		//显示价格
image: "HYPERLINK "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg",	 //车系图片
serialName: "君威",		 //车系名称
deadline: "2014-08-02",	 //截止时间
discount: "25000"		 //优惠价格
},
...
]
}

2.6.3. 团购-活动详细


请求URI: http://mrobot.pcauto.com.cn/buy/price/activityDetail/{id}?areaId=1&modelId=0&dId=364171E5-73FE-4907-9C3F-F5D47B355F2F
HTTP请求方式:get
返回格式:html
请求参数

参数名类型必须说明
idnumberYES团购活动id
areaIdnumberYES城市id
modelIdnumberYES车型id,没有情况下传0
dIdnumberYES设备id

web页面数据后端请求接口:

正式环境URL:http://mai.pcauto.com.cn/gct/interface/get_gct_activity_detail.jsp?tsgId=4702
测试环境URL:http://dev3.pcauto.com.cn:9977/gouchetuan/interface/get_gct_activity_detail.jsp?tsgId=141

后端返回参数

{
 "models":[ //团购活动车型列表
  {"modelId":28740, //车型id
  "modelName":"君威 2014款 1.6T 时尚技术型", //车型名
  "price":19.989999771118164, //车型价格
  "discountPrice":17.489999771118164, //车型优惠价
  "discount":2.5 //车型优惠幅度
  },...],
  "id":4702,	 //团购活动id
  "dealerId":15964, //经销商id
  "person":7, //活动参与人数
  "title":"别克厂家直销会 百万钜惠让利等你来", //活动标题
   "activityInfo":"...", //活动详情
   "serialId":3543, //车系id
  "image":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/28/c19/28064316_1382955211312_350x260.jpg", //车系图片
  "serialName":"君威", //车系名
  "deadline":"2014-08-02", //截止时间
  "grouponInfo":[ //团购信息列表
     {"text":"2000豪礼,1000元油卡等着你","name":"现场抽奖"},
     {"text":"18期0利率,2-3年低利率","name":"贷款优惠"}
   ],
   "city":"广东 广州" //活动城市
}

2.6.3. 团购报名接口信息

(web端加入团购后,需要同步给微信推送平台的接口,app没用到)
未上线
测试url :  http://v12.pcauto.com.cn:8004/interface/app/do_autobuyOrder.jsp
正式url :  http://wxzs.pcauto.com.cn/interface/app/do_autobuyOrder.jsp
PS:团购活动ID测试环境请使用:61,91,137,142,151,161 .
参数描述:
@param callback 回调函数名,选填
@param dId 设备ID,必填
@param acId 团购活动ID,必填
@return json 例: {"msg":"报名成功!","result":true}

2.6.4. 三人行报名接口 (发起团购的接口)

正式环境URL:(已上线  注:正式环境的报名数据会派发给经销商,测试开发过程慎用)
http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8
测试环境URL:
http://v37.pcauto.com.cn:8080/gouchetuan/action/do_order.jsp?req-enc=utf-8
HTTP请求方式:post
返回格式:json
请求参数
carSerialId:车系ID【必填】
userName:报名人名称【必填】
phone:报名人电话【必填】
regionId:城市id【必填】
provinceId:省份id【选填】
origin:平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志【必填】
isInitMsg:1,【三人行报名,固定为1】
referer:来源URL(当前页面的url)【必填】(购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/   用于记录报名来源于购车app)
返回参数
{
code:200		//报名成功
}
204 - 表单必填参数不完整
500 - 系统错误

2.6.5. 团购投诉接口信息

说明:
使用post方式请求
测试请求url:
http://v17.pcauto.com.cn:8002/dealer/interface/tuangou/tuangou_report.jsp
上线后请求url:
http://price.pcauto.com.cn/dealer/interface/tuangou/tuangou_report.jsp
参数:
name:投诉人姓名
phone:投诉人电话
content:投诉内容
_charset:字符编码(取值utf-8)
callback:回调函数名称(可以不传,按具体情况使用)
返回值:
不传callback参数
  成功返回:{"status":"success"}
  失败返回:{"status":"error"}
传callback参数
  成功返回:callback_name({"status":"success"})
  失败返回:callback_name({"status":"error"})

2.6.5. 获取车系/车型最近30天4S店报名人数

 (Web用到,app未用到)
获取车系/车型最近30天4S店报名人数
正式环境URL:(已上线)
http://price.pcauto.com.cn/dealer/interface/order/order_info.jsp
测试环境URL:
http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp

HTTP请求方式:get
返回格式:json
请求参数
m:调用方法(getCountBySG:获取某个车系报名人数;getMCountBySG:获取某个车系下所有车型的报名人数)【必填】
sgId:车系id【必填】
callback:回调函数

返回结果
getCountBySG
[{"result":true,"count":30971,"msg":"报名人数获取成功"}]

getMCountBySG
[
    {
        "result":true,
        "count":[
            {
                "modelId":12168,
                "count":3
            },
            {
                "modelId":11309,
                "count":3
            },
            {
                "modelId":11310,
                "count":3
            },
            {
                "modelId":12158,
                "count":3
            },
           {
                "modelId":27110,
                "count":3
            }
        ],
        "msg":"报名人数获取成功"
    }
]

2.7 我的

2.7.1. 我的-订阅列表

测试url :  http://v12.pcauto.com.cn:8004/interface/app/get_autobuyApp.jsp 正式url :  http://wxzs.pcauto.com.cn/interface/app/get_autobuyApp.jsp
参数描述:
@param callback 回调函数名,选填
@param m 调用的方法,必填,取值m=getFavorList : 获取我的爱车列表
@param dId 设备ID,必填
@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param page 分页,当前页数, 选填
@param size 分页,页面长度, 选填
json 例:

    {"models":"1,360,518","serialgroups":"3424,4254"}

2.7.2. 我的-添加车型/车系订阅

未上线 测试url :  http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp 正式url :  http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp
参数描述:

@param callback 回调函数名,可选
@param m 调用的方法,必填,m的取值,{m=modelFavor,serialgroupFavor},参数说明如下:
 取值1,m=modelFavor : 车型 新增/取消 收藏
   @param dId 设备ID,必填
   @param mId 车型ID,必填
   @param func 功能类型,必填,取值{add:新增收藏,cancle:取消收藏}
     
 取值1,m=serialgroupFavor : 车系 新增/取消 收藏
   @param dId 设备ID,必填
   @param sgId 车系ID,必填
   @param func 功能类型,必填,取值{add:新增收藏,cancle:取消收藏}

2.7.3. 我的-团购列表


未上线
测试url :  http://v12.pcauto.com.cn:8004/interface/app/get_autobuyOrder.jsp
正式url : http://wxzs.pcauto.com.cn/interface/app/get_autobuyOrder.jsp
参数描述:
@param callback 回调函数名,选填
@param m 调用的方法,必填,取值=getOrderList : 获取我的团购报名列表
@param dId 设备ID,必填
@param bt 报名-起始时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param et 报名-结束时间, 选填 格式为:yyyy-MM-dd 例:2014-08-11
@param page 分页,当前页数, 选填
@param size 分页,页面长度, 选填

@return json 例:
{ 
 "data": [
  {
   "acId": 191, ##团购活动id
   "deadline": "2014-08-06", ##活动截至时间
   "discount": 0.20, ##优惠
   "discountPrice": 11.07, ##优惠价
   "image": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1406/25/c5/35654388_1403678285814_350x260.jpg", ##图像
   "orderCount": 3, ##报名人数
   "sgId": 8670, ##车系id
   "sgName": "奥迪Q3", ##车系名
   "title": "奥迪A4L 2013款 2.0 40TFSI quattro" ##活动标题
  },{
   ...其他团购信息
  }]
}

2.7.4. 我的-陪购列表

     //1.0.0 本期不用做

2.7.4. 我的-消息推送定制

未上线
测试url :  http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp
正式url :  http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp
参数描述:
 @param callback 回调函数名,可选
 @param m 调用的方法,必填,m的取值,{m= triggerSync},参数说明如下:
 @param dId 设备ID,必填
 @param push 开关值,必填 0:不推送, 1:推送
 @param type 功能类型,必填,取值:1:推送总开关. 2:夜间推送开关. 3:团购推送开关. 4:优惠推送开关.

2.7.5. 我的-车库数据启动同步接口

测试url :  http://v12.pcauto.com.cn:8004/interface/app/do_autobuyApp.jsp
正式url :  http://wxzs.pcauto.com.cn/interface/app/do_autobuyApp.jsp
参数描述:
@param callback 回调函数名,可选
@param m 调用的方法,必填,m=launchSync : 启动购车APP时同步:
   @param dId 设备ID,必填
   @param app app名称,必填
   @param mIds 车型收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟mIds的值完全同步)
   @param sgIds 车系收藏ids 英文","号相隔 , 必填.若无收藏可不传此参数.(DB会跟sgIds的值完全同步)
   @param token app标识,选填
   @param rId 用户所在城市id,选填
   @param rName 用户所在城市名称,选填
   @param pushSwitch 推送总开关,选填 0:不推送, 1:推送
   @param nightPushSwitch 夜间推送开关,选填 0:不推送, 1:推送
   @param groupbuySwitch 团购推送开关,选填 0:不推送, 1:推送
   @param discountSwitch 优惠推送开关,选填 0:不推送, 1:推送

2.7.8 根据车系/车型获取行情接口

正式地址:(已上线)
 http://price.pcauto.com.cn/dealer/interface/app/model_news4fav_json.jsp
测试地址:
 http://v17.pcauto.com.cn:8002/dealer/interface/app/model_news4fav_json.jsp
请求参数:
areaId  地区id
sgIds  车系id串,逗号分隔多个
modelIds  车型id串,逗号分隔多个
date	 日期,格式:yyyy-MM-dd
callback  js回调函数名称

返回值:
{
    "sgNews":[
        {
            "newsCreateTime":"2014-08-18 09:04:19.0",
            "newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html",
            "newsId":"5319592",
            "newsName":"朗逸最高优惠0.5万 现车充足",
            "sgId":"3225"
        }
        ……
    ],
"modelNews":[
        {
            "newsCreateTime":"2014-08-18 09:04:19.0",
            "newsUrl":"http://m.pcauto.com.cn/auto/market/30830-5319592.html",
            "newsId":"5319592",
            "newsName":"朗逸最高优惠0.5万 现车充足",
            "modelId":"3225"
        }
        ……
    ]
}

2.8 工具

2.8.1. 购车计算器/车险计算器

备注:经与接口讨论,web端同事建议本地计算

2.9 图集

2.9.1. 车系/车型图片筛选条件(已有接口)

 请求URL:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=3404
          http://mrobot.pcauto.com.cn/v2/price/pictureConditions?modelId=26593
 HTTP请求方式:get
 是否需要登录:否
 返回格式:json
 缓存方式:无
 缓存时间:1小时
 请求参数:serialId: 车系id,必填
           modelId: 车型id,可选,当modelId不为0时,返回参数的models字段为空数组
 返回参数:
 {
    "models":[
        {
            "id":123,
            "modelName":""
        }
    ],
    "types":[
        {
            "id":1,
            "typeName":"外观"
        }
    ],
    "colors":[
        {
            "id":1,
            "colorName":""
        }
    ]
}
 请求后端URL:
             http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp

2.9.2. 车系/车型图片筛选查询(已有接口)

请求URL: http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=3404&modelId=26593&colorId=16133&typeId=1
 HTTP请求方式:get
 是否需要登录:否
 返回格式:json
 缓存方式:无
 缓存时间:1小时
 请求参数:
 serialId:车系id
 modelId:车型id
 typeId:图片类型id
 colorId:颜色id
 pageNo:第几页
 pageSize:每页显示多少条
 返回参数:
{
    "data": [
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932203312_120x90.jpg"
        },
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932206296_120x90.jpg"
        },
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932209296_120x90.jpg"
        },
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932212468_120x90.jpg"
        },
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932215640_120x90.jpg"
        },
        {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
        }
    ],
    "pageCount": 4,
    "pageNo": 1,
    "pageSize": 6,
    "total": 19
}
 请求后端URL:
             http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp

2.9.3. 车系/车型 全部图片查询(不用开发,等待下一版本设计)

 请求URL: 待开发
 HTTP请求方式:get
 是否需要登录:否
 返回格式:json
 缓存方式:无
 缓存时间:1小时
 请求参数:
     serialId:车系id
    modelId:车型id
 返回参数:
{
 [
   {
     "groupid":23,// 图片分类id
     "name":"外观",
     "total":1024,
     "pictures":[// 只返回6张
       {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
       },
       {
            "bigPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_500.jpg",
            "smallPath": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/08/c4/24272527_1375932218718_120x90.jpg"
       }
       ...
     ]
   },
   ...
 ]
}