wiki:pcauto_4.3.0/interface

Version 33 (modified by leijingtang, 12 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1 降价列表
    2. 2.2 优惠详情
    3. 2.3 经销商详情
    4. 2.4 经销商在售车系页面
    5. 2.5 根据品牌id获取车系列表
    6. 2.6 精准选车结果
    7. 2.7 车系终端
    8. 2.8 车系参配
    9. 2.9 车系的经销商列表
    10. 2.10 车主点评列表
    11. 2.11 车主点评详情
    12. 2.12 车型终端
    13. 2.13 购车计算器
    14. 2.14 优惠活动列表
    15. 2.15 优惠活动详情
    16. 2.16 获取我的订阅
    17. 2.17 增加订阅
    18. 2.18 删除订阅
    19. 2.19 根据车系id获取对应论坛数据
    20. 2.20 优惠活动报名接口
    21. 2.21 判断车系或者车型是否已经收藏

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:

请求参数
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 优惠详情

接口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 经销商详情

接口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 经销商在售车系页面

接口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 根据品牌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 精准选车结果

接口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 车系终端

接口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:

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

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

2.9 车系的经销商列表

接口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 车主点评列表

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

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

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

2.11 车主点评详情

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

请求参数:


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

2.12 车型终端

接口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 购车计算器

接口URL:

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

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

2.14 优惠活动列表

接口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 优惠活动详情

接口URL:

请求参数:
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请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
 返回结果：
和http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=1&pageNo=1&pageSize=1000一样

2.17 增加订阅

 备注：增加订阅，说明：支持批量添加。由于4.3添加了车系收藏功能，收藏功能和订阅功能是两个不同的模块；而原有的订阅功能就是收藏。为了将两者区分开来，需要另外新建订阅管理后台和相关接口。详细查阅原型：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 请求URL：
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id:用户登陆后获得的认证id
        serials：车系id数组
 返回参数：
        {
    "serials":[
        {
            "carId":518669,
            "carPic":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1207/16/c4/12351711_12351711_1342426522843_270x202.jpg"
        }
...
    ]
}

2.18 删除订阅

 备注：删除订阅，说明：不支持批量删除。由于4.3添加了车系收藏功能，收藏功能和订阅功能是两个不同的模块；而原有的订阅功能就是收藏。为了将两者区分开来，需要另外新建订阅管理后台和相关接口。详细查阅原型：http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.3.0/v3/
 请求URL：
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id:用户登陆后获得的认证id
        carId：爱车id
 返回参数：
        {
            code: 1,
            message: "删除数据成功"
        }

2.19 根据车系id获取对应论坛数据

 备注：
 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/newForums/14359?idType=serial&pageNo=1&pageSize=19&orderby=replyat

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

 返回参数：
        不变

2.20 优惠活动报名接口

 备注：
 请求URL：

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

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

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

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

 备注：
 请求URL：

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

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

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