[[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），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况
}}}



== 2.接口列表 ==

=== 2.1 [=#point2.1 车系参配] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/serialDetail.xsp?serialId=4313&subscributedIds=30499,36337
[[BR]]现应用接口：
{{{
http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313 车系概览页车型列表接口
http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_overview.jsp?mid=30499 车型概览接口
http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_params.jsp?mid=30499 车型参数接口
http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp?m=getMCountBySG&sgId=4313 订单数
}}}
[[BR]]原接口：
{{{
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4313
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialId||String||Y||车系ID||
||subscributedIds||String||N||已订阅的车型id||
[[BR]]返回结果:
{
    "detailArray": [
        {
            "detail": [
                {
                    "groupDetail": [
                        "全国4S店",
                        "2368笔"
                    ],
                    "groupName": "询价订单"
                },
                {
                    "groupDetail": [
                        "前制动器类型",
                        "通风盘式",
                        "后制动器类型",
                        "通风盘式",
                        "驻车制动类型",
                        "电子驻车",
                        "前轮胎规格",
                        "245/45 R18 ",
                        "后轮胎规格",
                        "245/45 R18 ",
                        "备胎规格",
                        "非全尺寸"
                    ],
                    "groupName": "车轮制动"
                
                }...
                }
                
    ],
    "groupNameArray": [
        "询价订单",
        "价格",
        "基本参数",
        "车身",
        "发动机",
        "电动机",
       .....
    ]
}

=== 2.2 [=#point2.2 车型参配] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/buy/price/modelDetail/{modelId}?areaId=1&fmt=json
[[BR]]现应用接口：
{{{
http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid={modelId} 基础数据
http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34224 参数
}}}

[[BR]]原接口：
{{{
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||modelId||String||Y||车型ID||
||areaId||String||Y||地区id||
[[BR]]返回结果:
[[BR]]{
"baseParameter":
[
    "厂商",
    "一汽奥迪",
    "级别",
    "中大型车",
    "上市时间",
    "2014-01",
    "发动机"...],
  "gfPrice": "38.3万",
    "groupNameArray": [
        "询价订单",
        "价格",
        "基本参数",
        "车身",
        "发动机",
        "电动机",
        "变速箱",
        "底盘转向",
     ...
    ],
    "kind": "中大型车",
    "manufacturer": "一汽奥迪",
    "minPrice": "5.75万",
    "modelName": "奥迪A6L 2014款 2.0 TFSI 手动基本型",
    "price": "38.3",
    "serialGorup": "奥迪A6L",
    "serialGorupId": 4313,
    "shortName": "2.0 TFSI 手动基本型",
    "state": "在售",
    "total": "0",
    "url": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_80x60.jpg",
    "url_120x90": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg",
    "url_400x300": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_400x300.jpg",
    "groupNameArray":[
    "询价订单",
    "价格",
    "基本参数",
    "车身",
    "发动机",
    "电动机"...],
    "gfprice":"38.3万",
    "brand":"奥迪",
    "detail":[   {
        "groupDetail": [
            "全国4S店",
            "0笔"
        ],
        "groupName": "询价订单"
    }......]
}

=== 2.3 [=#point2.3 车型对比] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/buy/price/detailCompare?modelIds=xx1,xx2&fmt=json
[[BR]]现应用接口：
{{{
http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid={modelId} 基础数据
http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34224 参数
}}}

[[BR]]原接口：
{{{
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||modelId||String||Y||车型ID||
||areaId||String||Y||地区id||
[[BR]]返回结果:
[[BR]]{
"baseParameter":
[
    "厂商",
    "一汽奥迪",
    "级别",
    "中大型车",
    "上市时间",
    "2014-01",
    "发动机"...],
  "gfPrice": "38.3万",
    "groupNameArray": [
        "询价订单",
        "价格",
        "基本参数",
        "车身",
        "发动机",
        "电动机",
        "变速箱",
        "底盘转向",
     ...
    ],
    "kind": "中大型车",
    "manufacturer": "一汽奥迪",
    "minPrice": "5.75万",
    "modelName": "奥迪A6L 2014款 2.0 TFSI 手动基本型",
    "price": "38.3",
    "serialGorup": "奥迪A6L",
    "serialGorupId": 4313,
    "shortName": "2.0 TFSI 手动基本型",
    "state": "在售",
    "total": "0",
    "url": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_80x60.jpg",
    "url_120x90": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg",
    "url_400x300": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_400x300.jpg",
    "groupNameArray":[
    "询价订单",
    "价格",
    "基本参数",
    "车身",
    "发动机",
    "电动机"...],
    "gfprice":"38.3万",
    "brand":"奥迪",
    "detail":[   {
        "groupDetail": [
            "全国4S店",
            "0笔"
        ],
        "groupName": "询价订单"
    }......]
}





=== 2.4 [=#point2.4 我要优惠] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/getPromotion.xsp?v=1.1.0&modelId=20062&modelName=奥迪&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount

[[BR]]现应用接口：
{{{
http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0
http://mrobot.pcauto.com.cn/v3/price/provinceCityList城市数据
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||modelId||String||Y||车型ID||
||areaId||String||Y||地区id||
||serialId||String||Y||车系id||
||dealerId||String||N||经销商id||
||name||String||N||提交名称||
||tel||String||N||提交电话号码||
||appKey||String||N||魔方appKey||
||chId||String||N||设备类型||
||devId||String||N||设备ID||
||referer||String||N||备注||
||v||String||N||版本号||

=== 2.5 [=#point2.5 优惠详情] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?marketId=7033340&modelId=33314

[[BR]]现应用接口：
{{{
http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId={marketId}+&modelId={modelId}
http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId={marketId}
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||modelId||String||Y||车型ID||
||marketId||String||Y||优惠ID||

=== 2.6 [=#point2.6 车型列表] ===

[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4_v12/{serialGroupId}?pageNo=1&pageSize=20&areaId=1

[[BR]]现应用接口：
{{{
http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=8670
http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=8670
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId=8670&rId=1;
}}}
[BR]原mrobot接口：http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/8670?pageNo=1&pageSize=20&areaId=1
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialGroupId||String||Y||车型ID||
||areaId||String||Y||地区ID||
[BR]返回结果：
{
    "advantage": "动力输出流畅，后段爆发力足，整体隔音优秀",
    "bbsId": "17365",
    "brand": "奥迪",
    "brandId": "1",
    "disadvatage": "后排腿部空间和头部空间较为局促",
    "displacement": "1.4T 2.0T",
    "gearbox": "手动 双离合",
    "kind": "紧凑型SUV",
    "manufacturer": "一汽奥迪",
    "manufacturerId": "1",
    "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_120x90.jpg",
    "photoTotal": 2501,
    "photo_400x300": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_400x300.jpg",
    "priceRange": "24.98~42.88万",
    "sections": [
        {
            "data": [
                {
                    "config": "7挡双离合 前置前驱 ",
                    "id": "33293",
                    "introduce": 0,
                    "isNews": "0",
                    "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1404/28/c15/33660207_1398675582054_120x90.jpg",
                    "price": "28.98",
                    "rjBzzw": 5,
                    "state": "在售",
                    "status": "在售",
                    "title": "2015款 35 TFSI 进取型"
                }
    ],
    "serialGroupName": "奥迪Q3",
    "sgAverageScore": 4.33,
    "shareUrl": "http://price.pcauto.com.cn/sg8670/",
    "structure": "SUV"
}