[[TOC]]

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

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


== 2.接口列表 ==

=== 2.1 [=#point201 降价列表]===
{{{

接口URL:

请求参数
areaId:地区id
brandId:品牌id
serialId:车系id
modelId：车型id
orderBy：popularity, newest, discountRange, lowestPrice；
               分别指按车型热度，按最新，按降价幅度，按最低价格

提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无
返回结果：
{
    "discount":[
        {
            "modelId":123,
            "modelName":"宝马X1 2013款 sDrive18i 手动型",
            "discountId":123,
            "dealerId":123,
            "dealerName":"榆林奥森奥迪",
            "infoId":123, // 该详情id
            "area":"广州白云",
            "dealerType":"4s店",
            "nowPrice":12.12,
            "discount":12,
            "image":"http://xxx.jpg",    //缩略图，尺寸为270x202
            "phone":"12345678"
        }

    ....
    ]
}
}}}


=== 2.2 [=#point202 优惠详情]===
{{{

接口URL:

请求参数
night     // 夜间模式
modelId  // 车型id
dealerId  // 经销商id
infoId  // 详情id

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
返回结果：
html页面，基本内容和wap端的优惠详情一致：
http://m.pcauto.com.cn/auto/market/45742-20776-4384408.html，
需求说明参考：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/，
设计稿待定
}}}


=== 2.3 [=#point203 经销商详情]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&modelId=29355&seq=308290002&modelName=%E6%9C%97%E9%80%B8+2014%E6%AC%BE+1.4TSI+DSG+%E8%93%9D%E9%A9%B1%E7%89%88&modelId2=29355

请求参数
modelId和modelName改成可选参数，其他不变

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
返回结果：
html页面，
需求说明参考：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/，
增加车型列表，列表数据可点，数据待定
}}}

=== 2.4 [=#point204 经销商在售车系页面]===
{{{

接口URL:todo

请求参数
serialId  // 车系id
dealerId // 经销商id


提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
{
    "serialId":123,
    "serialName":"",
    "dealerId":123,
    "dealerName":"经销商名字",
    "priceRange":"",
    "image":"http://xxxx.png",
    "models":[
        {
            "category":"1.6L",    //分类
            "modelsInCategory":[   // 分类里的车型
                {
                    "modelId":123,
                    "modelName":"车型名",
                    "image":"http://xxxx.jpg",   // 车型缩略图，尺寸350x260
                    "nowPrice":"12.12",
                    "discount":"12"
                }
...
            ]
        }
...

    ]
}

}}}


=== 2.5 [=#point205 根据品牌id获取车系列表]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/1

请求参数
不变


提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
 在原来的基础上增加一个isNew的字段，表示这款车系是不是新车
{
    "manufacturers":[
        {
            "brandIntroduction":"http://price.pcauto.com.cn/qcbk/ppgs/AlfaRomeo/1208/2068699.html",
            "brandName":"阿尔法罗密欧",
            "name":"阿尔法罗密欧",
            "serials":[
                {
                    "count":0,
                    "id":9190,
                    "kind":"跑车",
                    "name":"ALFA Gloria",
                    "photo":"http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9190.jpg",
                    "priceRange":"null",
                    "isNew":1
                }
            ]
        }
    ]
}
}}}

=== 2.6 [=#point206 精准选车结果]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v2/price/models/search?queryJson=%7B%22cluster_price%22:%5B%22150%E4%B8%87%E4%BB%A5%E4%B8%8A%22%5D,%22cluster_kind%22:%5B%22%E5%85%A8%E5%B0%BA%E5%AF%B8suv%22%5D%7D&pageNo=1&orderId=1&type=1

请求参数
不变


提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
修改priceRange字段的规则，不出整个车系的价格范围，而是出该车系里符合这个条件的车型的价格范围


}}}

=== 2.7 [=#point207 车系终端]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/serialv40/3225?v=4.0.0

请求参数
v=4.3.0
serialId  // 车系id

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：

调整样式和操作，去掉相关文章和车主点评按钮，添加购车优惠按钮，按钮事件pcautobrowser://concessions/?serialId=123&serialName=马自达


}}}

=== 2.8 [=#point208 车系参配]===
{{{

接口URL:

请求参数:
modelId1  // 左边的车型id，该参数的默认值是该车系下最热门的一款车
modelId2  // 右边的车型id
serialId  // 车系id
night  // 夜间模式

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
显示某车型的参数和对比结果，允许编辑。
删除按钮和客户端没有交互，全部由网页完成。
添加按钮触发：pcaction://addModel?to=left，to参数有left和right两个值，分别对应左右两个车型。

}}}


=== 2.9 [=#point209 车系的经销商列表]===
{{{

接口URL:

请求参数：
serialId  // 车系id
pro  // 省份
city // 城市
night // 夜间模式

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
参考http://mrobot.pcauto.com.cn/v3/price/modelsv40/29355?areaId=1&isCompared=1&app=pcautobrowser&v=4.1.0

该页面下的一些跳转，如果参数包含modelId和modelName的话，取该车系下最热门的一款车作为代替。
}}}


=== 2.10 [=#point210 车主点评列表]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/commentList/3225

请求参数:
night // 夜间模式

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
重新调整样式，其他不变

}}}


=== 2.11 [=#point211 车主点评详情]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/commentDetail/21824

请求参数:


提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
重新调整样式，其他不变

}}}

=== 2.12 [=#point212 车型终端]===
{{{

接口URL:http://mrobot.pcauto.com.cn/v3/price/modelsv40/29355?areaId=1&isCompared=1&app=pcautobrowser&v=4.1.0

请求参数:
不变

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
调整样式，增加购车计算按钮：pcautobrowser://auto-calculator/modelId

}}}

=== 2.13 [=#point213 购车计算器]===
{{{

接口URL:

请求参数:
modelId  // 车型id
night // 夜间模式

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：


}}}


=== 2.14 [=#point214 优惠活动列表]===
{{{

接口URL:

请求参数:
areaId或者pro和city  // 地区参数


提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无
设计稿：todo
备注：
focus和data字段由cms提供，topFocus由madmin提供，
参考http://mrobot.pcauto.com.cn/v2/cms/channels/1?v=4.0.0的做法
返回结果：
{
    "data":[
        {
            "id":2,
            "discount":"25",
            "price":"65",
            "deadline":"2012-12-12",
            "image":"http://img0.pcauto.com.cn/pcauto/1401/14/g_3757705_1389682614382_240x160.jpg",
            "title":"全新劳恩斯或定名捷恩斯 北京车展发布",
            "serialName":"马自达"
        }
    ],
    "focus":[
        {
            "id":"4213159",
            "image":"http://img0.pcauto.com.cn/pcauto/nation/ycxc/1404/cla.jpg"
        }
    ],
    "topFocus":[
        {
            "to-uri":"pcautobrowser://information-article/1234",
            "image":"http://img0.pcauto.com.cn/pcauto/nation/ycxc/1404/cla.jpg"
        }
    ],
    "pageNo":1,
    "pageSize":5,
    "total":150
}


}}}


=== 2.15 [=#point215 优惠活动详情]===
{{{

接口URL:

请求参数:
night // 夜间模式

提交方式：GET
是否需要登录：否
返回格式：html 
缓存方式：无
缓存时间：无
设计稿：todo
返回结果：
参考http://mai.pcauto.com.cn/gct/s152/，重新设计模板

}}}



=== 2.16 [=#point216 获取我的订阅]===
{{{
 备注：我的订阅。由于4.3添加了车系收藏功能，收藏功能和订阅功能是两个不同的模块；而原有的订阅功能就是收藏。为了将两者区分开来，需要另外新建订阅管理后台和相关接口。详细查阅原型：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/

 请求url：http://192.168.20.223:8081/mrobot-data/pcauto/user/getSubscribeRecords.jsp
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id，请求接口时放cookie中或作为url参数

 返回结果：说明，除了第3中情况程序出错返回的响应状态为500，其他情况经返回200
1.未登录：
{
    "code": -1,
    "message": "用户未登陆"
}

2.程序出错：返回响应状态码500
{
    "code": -3,
    "message": "程序异常"
}

3.正常返回：
{
    "code": 0,
    "total": 5,
    "resultList": [
        {
            "id": 1,
            "userId": 24286812,
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/24/c16/23702964_1374654889218_270x202.jpg",
            "serialId": 3404,
            "serialName": "福克斯",
            "price": "9.98-16.99万"
        },
        {
            "id": 2,
            "userId": 24286812,
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/13/c9/24440713_1376387144385_270x202.jpg",
            "serialId": 354,
            "serialName": "马自达6",
            "price": "12.98-15.98万"
        },
        {
            "id": 3,
            "userId": 24286812,
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/16/c13/23389440_1373956410390_270x202.jpg",
            "serialId": 9306,
            "serialName": "马自达CX-5",
            "price": "16.98-25.28万"
        },
        {
            "id": 4,
            "userId": 24286812,
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1202/28/c3/10633808_10633808_1330395935562_270x202.jpg",
            "serialId": 3344,
            "serialName": "劳恩斯",
            "price": "39.8-58.8万"
        },
        {
            "id": 5,
            "userId": 24286812,
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/18/c4/28751120_1384764398437_270x202.jpg",
            "serialId": 9322,
            "serialName": "杰德",
            "price": "14.98-18.38万"
        }
    ]
}
}}}

=== 2.17 [=#point217 增加订阅]===
{{{
 备注：增加订阅，说明：支持批量添加。由于4.3添加了车系收藏功能，收藏功能和订阅功能是两个不同的模块；而原有的订阅功能就是收藏。为了将两者区分开来，需要另外新建订阅管理后台和相关接口。详细查阅原型：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 
 请求URL：http://192.168.20.223:8081/mrobot-data/pcauto/user/modifySubscribeRecord.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id，请求接口时放cookie中或作为url参数使用
        act: 添加订阅请用add，删除订阅请用delete
        param：收藏的车系数据，格式如下所示：
{
    "serialList": [
        {
            "serialId": 269811,
            "serialName": "马自达3",
            "price": "14.98-18.38万",
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/18/c4/28751120_1384764398437_270x202.jpg"
        },
        {
            "serialId": 424,
            "serialName": "宝马3系",
            "price": "28.3-66.2万",
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/05/c0/28324073_1383616337906_270x202.jpg"
        },
        {
            "serialId": 142,
            "serialName": "奔驰A级",
            "price": "25.2-35.8万",
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/28/c5/20336832_1367115633609_270x202.jpg"
        },
        {
            "serialId": 291740,
            "serialName": "蒙迪欧",
            "price": "17.98-26.58万",
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1310/17/c19/27624664_1382004008375_270x202.jpg"
        },
        {
            "serialId": 269811,
            "serialName": "马自达3",
            "price": "14.98-18.38万",
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/18/c4/28751120_1384764398437_270x202.jpg"
        }
    ]
}

返回结果：说明，除了第3中情况程序出错返回的响应状态为500，其他情况经返回200
1.未登录：
{
    "code": -1,
    "message": "用户未登陆"
}

2.请求参数错误：
{
    "code": -2,
    "message": "请求参数错误"
}

3.程序出错：返回响应状态码500
{
    "code": -3,
    "message": "程序异常"
}

4.正常返回：
{
    "code": 0,
    "userId": 24286812,
    "ids": [
        1,
        2,
        3,
        4,
        5,
        6,
        7
    ]
}
}}}

=== 2.18 [=#point218 删除订阅]===
{{{
 备注：删除订阅，说明：不支持批量删除。由于4.3添加了车系收藏功能，收藏功能和订阅功能是两个不同的模块；而原有的订阅功能就是收藏。为了将两者区分开来，需要另外新建订阅管理后台和相关接口。详细查阅原型：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 
 请求URL：http://192.168.20.223:8081/mrobot-data/pcauto/user/modifySubscribeRecord.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id，请求接口时放cookie中或作为url参数使用
        act: 添加订阅请用add，删除订阅请用delete
        ids：支持批量删除，如ids=1,2,3,4,5，此id为接口2.16中返回的id或2.17中返回的ids

返回结果：说明，除了第3中情况程序出错返回的响应状态为500，其他情况经返回200
1.未登录：
{
    "code": -1,
    "message": "用户未登陆"
}

2.请求参数错误：
{
    "code": -2,
    "message": "请求参数错误"
}

3.程序出错：返回响应状态码500
{
    "code": -3,
    "message": "程序异常"
}

4.正常返回：
{
    "code": 0,
    "userId": 24286812,
    "ids": [
        1,
        2,
        3,
        4,
        5,
        6,
        7
    ]
}
}}}

=== 2.19 [=#point219 根据车系id获取对应论坛数据]===
{{{
 备注：
 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/newForums/3404?idType=serial&pageNo=1&pageSize=19&orderby=replyat

 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
在原来的基础上增加：
idType // 表示该url上的id类型，如果是serial为车系id，如果是forum则为论坛id
其他不变

 返回参数：
        不变
}}}


=== 2.20 [=#point220 优惠活动报名接口]===
{{{
 备注：
 请求URL：

 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：

modelId  // 车型id
name  // 姓名
photo  // 电话号码

 返回参数：
        {"resultCode":0,   // 1表示成功，0表示失败
         "msg":""}
}}}

=== 2.21 [=#point221 判断车系或者车型是否已经收藏]===
{{{
 备注：
 请求URL：

 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：

modelId  // 车型id
serialId // 车系id
common_session_id

 返回参数：
        如果已经登陆并且车系或者车型已经收藏，返回收藏id，否则返回-1
}}}