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
2.8 车系参配
接口URL:
请求参数
提交方式:GET
是否需要登录:否
返回格式:html
缓存方式:无
缓存时间:无
设计稿:todo
返回结果:
html,显示某车型的参数和对比结果,允许编辑,按钮事件todo
2.9 车系的经销商列表
接口URL:
请求参数
提交方式:GET
是否需要登录:否
返回格式:html
缓存方式:无
缓存时间:无
设计稿:todo
返回结果: