[[TOC]]

== 1.基本约定 ==
{{{
接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况
}}}

[[BR]]代理环境说明：
[[BR]]192.168.10.198 端口为 1080    连的是v80的测试环境（192.168.74.80）
[[BR]]192.168.10.199 端口为 1080    连的是dev40的开发环境（192.168.75.40）



== 接口列表 ==
== 1.历史记录 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/listMinModelPrice.xsp?modelIds=33313,33314,33315&areaId=1 [[BR]]
**后端接口**

>http://price.pcauto.com.cn:8001/interface/iphone/atom/dealer/list_min_model_price_json.jsp?vs=1.3&rId=1&mIds=33313,33314,33315 本地最底价
>http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?vs=1.3&mIds=33313,33314,33315 官方价
**说明**

>areaId不传的情况下默认为1

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||modelIds||车型||String|| 无||是||
||areaId||地区Id||int||1||是||

**返回**

{{{#!java
 {
    "models": [
        {
            "mId": 33314,
            "minPrice": 28.3,
            "markDown": 4.99
        },
        {
            "mId": 33315,
            "minPrice": 31.32,
            "markDown": 5.96
        },
        {
            "mId": 33313,
            "minPrice": 26.59,
            "markDown": 4.69
        }
    ],
    "code": 1
}

}}}

== 2.车系列表 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/getSerialListByBrandId.xsp?brandId=1&type=1 [[BR]]
**后端接口**

>http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?vs=1.3&bid=1&type=1 车系列表数据 [[BR]]
>http://price.pcauto.com.cn/interface/iphone/atom/price/hot_model_list_json.jsp?vs=1.3&brandId=1 本地热门车型最低价
**说明**

>本地热门车型最低价新加的接口

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||brandId||品牌||int|| 1||是||
||typeId||类型Id||int||1||是||

**返回**

{{{#!java
  {
   "manufacturers":[{
        "brandName": "奥迪",
        "name": "测试的",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": []
    },
    {
        "brandName": "奥迪",
        "name": "一汽奥迪",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": [
            {
                "id": 3524,
                "name": "奥迪A4L",
                "kind": "中型车",
                "priceRange": "27.28~57.81 万",
                "isNew": 0,
                "sellStatus": 3,
                "carVersion": 1,
                "carField": 4,
                "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_180x135.jpg",
                "count": 43
            } .....
   ],
   "models":[ {
        "mId": 30822,
        "serialGroupId": 5
    },
   {
        "mId": 26741,
        "serialGroupId": 6
    }.....
    ]
   } 

}}}


== 3.发起投票 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/buy/price/vote/initiateVote [[BR]]

**说明**

>发起投票接口

**提交方式**

> POST

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||param||投票json数据||json|| 无||是||

**请求参数格式**

{{{#!java
  {
    “deviceId”: ”设备唯一标识”,
    “text”: ”帮我选车吧”,
    “validTime”: 3,
    “cars”: [
        {
            “serialId”: 4313,
            “areaId”: 12,
            “name”: ”奥迪A4L”,
            “image”: ”图片url”,
            “price”: ”￥27~30万”
        },
        {
            “serialId”: 4313,
            “areaId”: 12,
            “name”: ”奥迪A4L”,
            “image”: ”图片url”,
            “price”: ”￥27~30万”
        }
    ]
}

}}}

**字段说明**

||= 参数名 =||= 参数含义 =||
||deviceId||设备唯一标识
||text||投票文案
||validTime||有效时间，单位(天)，一周7天，一个月30天
||cars||车系列表，json数组
||serialId||车系id
||areaId||投票发起人所在区域id
||name||车系名称
||image||车系图片的url
||price||车系价格


**返回值**
返回结果：
{{{#!java
{
“code”:200,
“msg”:”投票成功”
}
}}}
**返回码**
200- 投票成功[[BR]]
405- 需要使用POST请求[[BR]]
400- 请求参数有误[[BR]]
500 - 系统错误[[BR]]


== 4.投票列表 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/buy/price/vote/getVotes?deviceId={deviceId} [[BR]]
>样例：http://mrobot.pcauto.com.cn/buy/price/vote/getVotes?deviceId=4e668331ec9d3275a7da459f6748a76d [[BR]]

**说明**

>查询投票列表接口

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||deviceId||设备唯一标识||int|| 无||是||

**返回结果格式**

{{{#!java
  {
    "votes": [
        {
            "cars": [
                {
                    "areaId": 12,
                    "image": "url",
                    "name": "奥迪 A4L",
                    "price": "￥27~30万",
                    "serialId": 4313
                }
            ],
            "status": 0,
            "validTime": {
                “start”: ”2015-05-30”,
                “end”: ”2015-06-30”
            },
            "voterCount": 8,
            “id”: 3241
        }
    ],
    “code”: 200,
    “msg”: ”成功”
}

}}}

**字段说明**

||= 参数名 =||= 参数含义 =||
||votes||投票列表，json对象
||cars||车系列表，json对象
||serialId||车系id
||areaId||投票发起人所在区域id
||name||车系名称
||image||车系图片的url
||price||车系价格
||status||投票状态，0：进行中，1：关闭，2：结束
||validTime||有效时间，json对象
||start||开始时间，字符串
||end||结束时间，字符串
||id||投票唯一标识
||code||响应码
||msg||响应信息


**返回码**
405- 需要使用GET请求[[BR]]
400- 请求参数有误[[BR]]
500 - 系统错误[[BR]]

== 5.更新投票状态 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/buy/price/vote/operateVote/{voteId}?opId={opId} [[BR]]
>样例：http://mrobot.pcauto.com.cn/buy/price/vote/operateVote/2141?opId=1 [[BR]]

**说明**

>关闭，删除投票接口

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||voteId||投票唯一标识||int|| 无||是||
||opId||操作标识，1：关闭，3：删除||int|| 无||是||

**返回结果格式**

{{{#!java
  {
“code”:200,
“msg”:”成功”
}
}}}

**返回码**[[BR]]
200- 成功[[BR]]
405- 需要使用GET请求[[BR]]
400- 请求参数有误[[BR]]
500 - 系统错误[[BR]]

== 6.图片终端页   == 
>
http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/pictures.xsp?serialGroupId=4457&pageSize=60&pageNo=1&typeId=1&modelId=36339&colorId=0 [[BR]]
**后端接口**
>http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?vs=1.3&typeId=1&pageNo=1&pageSize=20&modelId=36339&serialGroupId=4457&cateId=1&colorId=0基础数据 
>http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?vs=1.3&mIds=36339 官方价
**说明**

>无

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||typeId||类型Id||int||1||是||
||pageNo||第几页||int||1||否||
||pageSize||分页个数||int||6||否||
||serialGroupId||车系Id||int||0||否||
||modelId||车型Id||int||0||否||
||cateId||种类Id||int||0||是||
||colorId||颜色Id||int||0||是||

**返回**

{{{#!java
 {
    "total": 37,
    "pageNo": 1,
    "pageSize": 2,
    "pageCount": 19,
    "title": "外观",
    "data": [
        {
            "modelId": "36339",
            "modelName": "奥迪Q5 2015款 40 TFSI 技术型 ",
            "bigPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_400x300.jpg",
            "smallPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_120x90.jpg",
            "gfPrice": "43.16"
        },
        {
            "modelId": "36339",
            "modelName": "奥迪Q5 2015款 40 TFSI 技术型 ",
            "bigPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487754873_400x300.jpg",
            "smallPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487754873_120x90.jpg",
            "gfPrice": "43.16"
        }
    ]
}

}}}


== 7.投票详情 == 
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/buy/price/vote/detailVote/{voteId} [[BR]]
>样例：http://mrobot.pcauto.com.cn/buy/price/vote/detailVote/1232[[BR]]

**说明**

>查询投票详细信息接口

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||voteId||投票id||int|| 无||是||

**返回结果格式**

{{{#!java
  {
    "code": 200,
    "msg": "成功",
    "vote": {
        "cars": [
            {
                "areaId": 12,
                "image": "url",
                "name": "奥迪 A4L",
                "price": "￥27~30万",
                "serialId": 4313,
                "ticketCount": 1,
                "percent": 100
            }
        ],
        "id": 1,
        "status": 0,
        "tickets": [
            {
                "name": "name",
                "reason": "reason",
                "time": "2015-06-02",
                "voter": "voter"
            }
        ],
        "validTime": {
            "end": "2015-06-05",
            "start": "2015-06-02"
        },
        "voteCount": 1
    }
}
}}}

**字段说明**

||= 参数名 =||= 参数含义 =||
||votes||投票列表，json对象
||cars||车系列表，json对象
||serialId||车系id
||areaId||投票发起人所在区域id
||name||车系名称
||image||车系图片的url
||price||车系价格
||ticketCount||车系得票数
||percent||车系得票百分数，整数
||tickets||选票信息，json对象
||voter||投票人名称
||time||投票日期
||name||车系名
||reason||投票原因
||status||投票状态，0：进行中，1：关闭，2：结束
||voteCount||总投票次数
||validTime||有效时间，json对象
||start||开始时间，字符串
||end||结束时间，字符串
||id||投票唯一标识
||code||响应码
||msg||响应信息


**返回码**
405- 需要使用GET请求[[BR]]
400- 请求参数有误[[BR]]
500 - 系统错误[[BR]]

== 8.车系综述 ==
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/serial.xsp?v=1.1.0&areaId=3&isSubscribed=0&serialId=4313&modelIds= [[BR]]
**后端接口**
{{{     
http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=4313  //车系概述基本数据
http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313     //车系概述最低价接口
http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=4313&size=3          //车系对比
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=3&serialId=4313  //判断是否有团购
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId4313&rId=3    //车系概述列表接口
http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?rid=3&sid=4313)             //获取本地最低价
http://price.pcauto.com.cn/interface/cms/region_400_json.jsp?rid=3）             //获取400电话
}}}
[BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/serial/4313?v=1.1.0&areaId=3&isSubscribed=0&modelIds=；}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式: html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||areaId||int||Y||地区ID||
||serialId||int||Y||车系id||
||isSubscribed||int||N||是否订阅||
||modelId||int||N||车型ID||
页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 
数据内容为： 
{{{#!java
{
	"kind": "中型车",
	"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_400x300.jpg",
	"priceRange": "27.28~57.81万",
	"cars": [{
		"title": " 1.8T 涡轮增压 160马力",
		"data": [{
			"id": "33318",
			"title": "2015款 1.8 30TFSI 手动舒适型",
			"price": "27.28",
			"config": "6挡手动 前置前驱 ",
			"state": "在售",
			"status": "在售",
			"isNews": "0",
			"rjBzzw": 5,
			"introduce": 0,
			"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1409/17/c6/38686815_38686815_1410941571968_120x90.jpg",
			"minPrice": "23.77",
			"paiLiang": "1.8",
			"jqx": 950,
			"glassPercent": 0.0019,
			"compared": "",
			"result": {
				"shoufu": 7.13,
				"loan": 170000,
				"monthPay": 0.52,
				"firstPayTotal": 9.87,
				"loantotal": 28.7,
				"total": 26.87
			}
		
		}]
	},
	{
		"title": " 2.0T 涡轮增压 224马力",
		"data": [{
			"id": "33319",
			"title": "2015款 2.0 45TFSI quattro个性运动版",
			"price": "35.3",
			"config": "7挡双离合 前置四驱 托森式差速",
			"state": "在售",
			"status": "在售",
			"isNews": "0",
			"rjBzzw": 5,
			"introduce": 0,
			"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/22/c6/39977239_39977239_1413950602832_120x90.jpg",
			"minPrice": "31.42",
			"paiLiang": "2.0",
			"jqx": 950,
			"glassPercent": 0.0019,
			"compared": "",
			"result": {
				"shoufu": 9.43,
				"loan": 220000,
				"monthPay": 0.68,
				"firstPayTotal": 13.41,
				"loantotal": 37.77,
				"total": 35.41
			}
		}
		]
	}]
}
}}}

{{{#!java
 协议说明：
 订阅： pcautobuy://addSubscribed/?serialId={{serialId}}&serialName={{serialName}}    取消订阅:pcautobuy://deleteSubscribed/?serialId={{serialId}}&serialName={{serialGroupName}}
 对比：pcaction://compare/?modelId={{id}}&modelName={{title}}&image={{photo}}  取消对比：pcaction://decompare/?modelId={{id}}&modelName={{title}}&image={{photo}}
 去团购：pcautobuy://model-activity-detail/?activityId={{activityId}}&areaId={{areaId}} 求组团：pcautobuy://serial-activity-initiate/?serialId={{serialId}}&serialName={{serialGroupName}}
 询底价：pcautobuy://auto-ask-price/?areaId={{areaId}}&dealerId=0&serialId={{serialId}}&modelId={{modelId}}&modelName={{modelName}}&image={{image}}&isMain=1
 去购车计算：pcautobuy://auto-calculator/{{id}}?modelName={{title}}&price={{minPrice}}&paiLiang={{paiLiang}}&rjBzzw={{rjBzzw}}&introduce={{introduce}}
 400电话咨询：pcaction://webview_tel/{{phone}}?name={{name}}
 我要优惠：pcautobuy://auto-get-promotion/?areaId={{param.areaId}}&dealerId={{dealerId}}&serialId={{../serialId}}&modelId={{../id}}&modelName={{../title}}&image={{../photo}}&isMain=1
 点击车型跳转：pcautobuy://model/?modelId={{id}}&modelName={{title}}&areaId={{areaId}}
}}}