wiki:pcauto_4.3.0/interface

Version 91 (modified by fuxingfang, 12 years ago) (diff)

--

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 降价列表(已上线)

接口URL:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&serialId=3524

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

提交方式:GET
是否需要登录:否
返回格式:json 
缓存方式:无
缓存时间:无
返回结果:

{
    "data": [
        {
            "area": "广东 广州",
            "dealerId": 15075,
            "dealerName": "广州锦龙奥迪",
            "dealerNewsId": 4500468, //行情id
            "dealerType": "4S店",
            "discount": 0,   //降价幅度
            "modelId": 11118,
            "modelName": "奥迪A4L 2009款 2.0 TFSI 舒适型",
            "phone": "400-860-0412",
            "price": 32.99
        },
        {
            "area": "广东 广州",
            "dealerId": 15075,
            "dealerName": "广州锦龙奥迪",
            "dealerNewsId": 4500468,
            "dealerType": "4S店",
            "discount": 0,
            "modelId": 11282,
            "modelName": "奥迪A4L 2009款 2.0 TFSI 标准型",
            "phone": "400-860-0412",
            "price": 29.88
        },
        {
            "area": "广东 广州",
            "dealerId": 15075,
            "dealerName": "广州锦龙奥迪",
            "dealerNewsId": 4500468,
            "dealerType": "4S店",
            "discount": 0,
            "modelId": 11284,
            "modelName": "奥迪A4L 2009款 2.0 TFSI 豪华型",
            "phone": "400-860-0412",
            "price": 38.86
        }
    ],
    "pageNo": 1,
    "pageSize": 20,
    "total": 3663
}

说明:dealerNewsId,行情id,请求“2.2 优惠详情”页面时的请求参数;
      discount,降价幅度。

2.2 优惠详情 (已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/promotionDetail/4442397?modelId=20690

请求参数:
行情id
modelId  // 车型id,可选
night     // 夜间模式

提交方式:GET
是否需要登录:否
返回格式:html 
缓存方式:无
缓存时间:无
返回结果:html页面

2.3 经销商详情 (可内测)

接口URL: (车型页经销商列表跳转至经销商详情url)http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?v=4.3.0&areaId=1&modelId=21803&seq=150750002&modelName=%E5%A5%A5%E8%BF%AAA4L+2013%E6%AC%BE+1.8+30TFSI+%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B
         (车系页“报价”经销商列表跳转至经销商详情url)http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?v=4.3.0&areaId=1&serialId=3524&modelId2=21803&modelName=%E5%A5%A5%E8%BF%AAA4L%202013%E6%AC%BE%201.8%2030TFSI%20%E6%89%8B%E5%8A%A8%E8%88%92%E9%80%82%E5%9E%8B&seq=654690001&dealerPrice=27.28

请求参数:跳转至经销商详情的入口有两个,分别是车型页经销商列表、车系页“报价”经销商列表,如上列出的两个url可知,[[BR]]

这两个入口跳转至经销商详情的请求参数是不同的,这些参数我会在这两个入口中的跳转协议中拼接好,客户端同事只需拿全这些参数进行请求跳转即可。


提交方式:GET
是否需要登录:否
返回格式:html 
缓存方式:无
缓存时间:无
返回结果:html页面

2.4 经销商在售车型页面 (已上线)

接口URL:http://mrobot.pcauto.com.cn/v3/price/getDealerSalesModels?dealerId=36406&serialId=3404

请求参数
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 根据品牌id获取车系列表 (已上线)

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

请求参数:不变


提交方式: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 精准选车条件(已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.3.0 (已上线)

请求参数:v:版本别,v=4.3.0


提交方式:GET
是否需要登录:否
返回格式:json 
缓存方式:无
缓存时间:无
设计稿:todo

2.6.1 精准选车结果(已上线)

接口URL:
        获取选车结果:http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&pageSize=20&v=4.3.0 (已上线)
        获取选车结果总数:http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&fmt=total&v=4.3.0 (已上线)

请求参数:price:价格
          jb:级别
          pl:排量
          bsx:变速箱
          pageNo:页数
          pageSize:每页显示条数
          v:版本别,此处v=4.3.0
          fmt:获取选车结果总数,fmt=total

说明:价格、级别、排量、变速箱参数的值使用[2.6 精准选车条件]中对应条件下value字段的值

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

2.7 车系终端(已上线)

接口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 车系参配(已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/detailComparev40?id1=21804&id2=18692&v=4.3.0
         http://mrobot.pcauto.com.cn/v3/price/detailComparev40?serialId=3524&v=4.3.0

请求参数:
id1  // 左边的车型id
id2  // 右边的车型id
serialId  // 车系id,此时获取该车系的第一款车型的参数
v        //版本号
night  // 夜间模式

提交方式:GET
是否需要登录:否
返回格式:html
缓存方式:无
缓存时间:无
设计稿:todo
返回结果:显示某车型的参数和对比结果,允许编辑。

添加按钮触发:pcautobrowser://serial-list-edit/?modelId=
删除按钮触发:pcaction://decompare/?modelId=

2.9 车系的经销商列表(已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=3524&areaId=1 (已上线)

请求参数:
        serialId:车系id
        areaId:地区id

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

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

2.10 车主点评列表(可内测)

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

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

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

2.11 车主点评详情 (可内测)

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

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

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

2.12 车型终端(已上线)

接口URL:http://mrobot.pcauto.com.cn/v3/price/modelsv40/29355?areaId=1&isCompared=0&app=pcautobrowser&v=4.3.0 (已上线)

请求参数:添加v=4.3.0

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

2.13 购车计算器(已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/vbuycar/24433?type=full (已上线)
         http://mrobot.pcauto.com.cn/v3/price/vbuycar/24433?type=loan (已上线)

请求参数:
        modelId: 车型id
        type:full,全额购车;loan,贷款购车
        night:夜间模式

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


2.14 优惠活动列表(已上线)

接口URL:http://mrobot.pcauto.com.cn/v3/price/activityList/1?pageNo=1&pageSize=20

请求参数:
地区id
pageNo:页数
pageSize:每页显示多少条


提交方式:GET
是否需要登录:否
返回格式:json 
缓存方式:无
缓存时间:无
设计稿:todo
备注:
data字段由商城提供,topFocus由madmin提供,
返回结果:
{
    "data":[
        {
            "id":2, //活动id
            "discount":"25",
            "price":"65",
            "deadline":"2012-12-12",
            "image":"http://img0.pcauto.com.cn/pcauto/1401/14/g_3757705_1389682614382_240x160.jpg",
            "title":"全新劳恩斯或定名捷恩斯 北京车展发布",
            "serialName":"马自达",
            "person":12 //报名人数
        }
    ],
    "topFocus":[
    {
        "cc-uri": "http://192.168.20.6?a=20d",
        "image": "http://img.pconline.com.cn/images/upload/upc/tx/bbs6/1312/24/c15/29958207_1387877831317_1024x1024.png",
        "seq": 7,
        "title": "活动列表焦点图跳转到活动详情页",
        "to-uri": "pcautobrowser://activity/?aId=123",
        "updateAt": 1400601600000,
        "vc-uri": "http://192.168.20.6?a=19d"
    },
    {
        "image": "http://imgad0.pcauto.com.cn/ivy/image/201310/10/13813889285530.jpg",
        "seq": 8,
        "title": "活动列表焦点图跳转到帖子页",
        "to-uri": "pcautobrowser://activity/?topicId=123",
        "updateAt": 1400601600000
    },
    {
        "image": "http://imgad0.pcauto.com.cn/ivy/image/201310/10/13813889285530.jpg",
        "seq": 9,
        "title": "活动列表焦点图跳转到专题",
        "to-uri": "pcautobrowser://activity/?uri=xxx",
        "updateAt": 1400601600000
    }
],
    "pageNo":1,
    "pageSize":5,
    "pageCount":12,
    "total":150
}

2.15 优惠活动详情(已上线)

接口URL: http://mrobot.pcauto.com.cn/v3/price/activityDetail/136

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

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

2.16 获取我的订阅(已上线)

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

 请求url:http://mdata.pcauto.com.cn/pcauto/user/getSubscribeRecords.jsp?common_session_id=9CE49958615D92D5B8727F5BB2EFD5C9F645E3C91B679F58 (已上线)
 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 增加订阅(已上线)

 备注:增加订阅,说明:支持批量添加。由于4.3添加了车系收藏功能,收藏功能和订阅功能是两个不同的模块;而原有的订阅功能就是收藏。为了将两者区分开来,需要另外新建订阅管理后台和相关接口。详细查阅原型:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 
 请求URL:http://mdata.pcauto.com.cn/pcauto/user/modifySubscribeRecord.jsp (已上线)
 HTTP请求方式:post
 是否需要登录:是
 返回格式:json
 缓存方式:无
 缓存时间:无
 请求参数:
        common_session_id:用户登陆后获得的认证id,请求接口时改参数可以放cookie中或也可以作为url参数使用
        act: 添加订阅请用add,删除订阅请用delete
        param:收藏的车系数据,格式如下所示:
        说明:包含中文的字段(serialName、price)在提交时请进行UTF-8编码
{
    "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 删除订阅(已上线)

 备注:删除订阅,说明:不支持批量删除。由于4.3添加了车系收藏功能,收藏功能和订阅功能是两个不同的模块;而原有的订阅功能就是收藏。为了将两者区分开来,需要另外新建订阅管理后台和相关接口。详细查阅原型:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 
 请求URL:http://mdata.pcauto.com.cn/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 根据车系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 优惠活动报名接口 (已上线)

 请求URL:
      我要优惠页面:http://mrobot.pcauto.com.cn/v3/price/getPromotion?dealerId=50680&modelId=26138&modelName=%E5%A5%A5%E8%BF%AAQ5+2013%E6%AC%BE+2.0+35TFSI+quattro+%E6%A0%87%E5%87%86%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1302/17/c0/18171294_1361066894468_350x260.jpg

      我要报名接口:http://mai.pcauto.com.cn/gct/action/do_order.jsp?req-enc=utf-8
                       请求参数:
                           modelId:车型id
                           userName:姓名
                           phone:手机号
                           dealerId:经销商id
                           regionId:城市id,
                           provinceId:省份id,
                           tsgId:活动id
                           origin:平台来源,0:未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志
                       
                       返回参数:200:请求成功
                                 204:请求参数不完整
                                 205:活动已结束
                                 206:活动未审核
                                 207:活动审核失败


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

2.21 判断车系或者车型是否已经收藏

 备注:因为服务器性能问题,改成本地实现。
客户端在每次收藏操作后将服务器数据同步到本地,以后就判断该车系或者车型是否在本地。
 请求URL:

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

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

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

2.22 获取车系图片筛选条件 (已上线)

 请求URL:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=3404
          http://mrobot.pcauto.com.cn/v2/price/pictureConditions?modelId=26593

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

serialId // 车系id,必填
modelId // 车型id,可选,当modelId不为0时,返回参数的models字段为空数组

 返回参数:
 {
    "models":[
        {
            "id":123,
            "modelName":""
        }
...
    ],
    "types":[
        {
            "id":1,
            "typeName":"外观"
        }
...
    ],
    "colors":[
        {
            "id":1,
            "colorName":""
        }
...
    ]
}

2.23 根据筛选条件出图片 (已上线)

 请求URL:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=3404&modelId=26593&colorId=16133&typeId=1

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

serialId // 车系id
modelId // 车型id
typeId // 图片类型id
colorId // 颜色id
pageNo  //第几页
pageSize //每页显示多少条

2.24 获取车系下的车型列表 (已上线)

 备注:
 请求URL:http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3225 (已上线)

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

 返回参数:


2.25 个人中心推广 (已上线)

    url:http://mrobot.pcauto.com.cn/v3/bbs/personalExtend  (已上线)
    作用:获取个人中心的推广内容,由编辑在cms里维护
    使用范围:汽车网app

    HTTP请求方式:get
    是否需要登录:否
    请求参数:none
    返回参数:
{
    "data": [
        {
            "title": "我是文字链",
            "to-uri": "pcautobrowser://information-article/id"
        }
    ]
}