wiki:pcauto_4.3.0/interface

Version 13 (modified by leijingtang, 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:

请求参数
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


提交方式:GET
是否需要登录:否
返回格式:html 
缓存方式:无
缓存时间:无
设计稿:todo
返回结果:
调整样式和操作,去掉相关文章和车主点评按钮,添加购车优惠按钮,按钮事件todo