[[TOC]]
== 1.基本约定 ==
[[BR]]mrobot开发机代理:192.168.10.199 端口为 1080
[[BR]]mrobot测试机代理:192.168.10.198 端口为 1080
[[BR]]接口通用参数
[[BR]]req_enc=utf-8(必须放url后面)
[[BR]]resp_enc=utf-8(必须放url后面)
[[BR]]common_session_id=xxxx(以cookies中的优先)
[[BR]]接口URL: 接口URL
||参数名||类型||必须||说明||
说明文档参数:添加某特定参数可以直接看接口文档
[[BR]]是否需要登录:是|否
[[BR]]返回格式:json|xml|ssi,
[[BR]]缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存()
[[BR]]缓存时间:缓存时间
[[BR]]返回结果:结果可能情况
== 2.接口列表 ==
=== 2.1 [=#point2.1 资讯] ===
=== 2.1.1 [=#point2.1.1 文章收藏批量操作] ===
(接口已完成,测试请连web开发机代理)
[[BR]]请求url:http://mrobot.pcauto.com.cn/v2/cms/batchArticles
[[BR]]后端地址:http://bip.pcauto.com.cn/intf/article.jsp
[[BR]]请求方式:post
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||act||String||必须||act=batchDelArtCollect表示批量取消收藏||
||articleIds||String||必须||文章id串,“,”逗号分隔,如:1258,46816||
||siteId||int||必须||站点id:(1:online(电脑网);2:auto(汽车网);3:games(游戏网);4:lady(时尚网);5:baby(亲子网);6:house(家居网))||
[[BR]]返回结果:
[[BR]]{"code":1,"message":"收藏/取消收藏文章成功"}
[[BR]]{"code":-1,"message":"登录后才能操作"}
[[BR]]{"code":-1,"message":"未指明动作"}
[[BR]]{"code":-1,"message":"缺少文章ID"}
[[BR]]{"code":-1,"message":"缺少参数siteId"}
=== 2.1.2 [=#point2.1.2 获取账号的收藏文章] ===
(接口已完成,测试请连web开发机代理)
[[BR]]请求url:http://mrobot.pcauto.com.cn/v2/cms/getMyCollection
[[BR]]后端地址:http://bip.pcauto.com.cn/intf/article.jsp; cms:http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp
[[BR]]请求方式:post
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||siteId||int||必须||站点id:(1:online(电脑网);2:auto(汽车网);3:games(游戏网);4:lady(时尚网);5:baby(亲子网);6:house(家居网))||
||pageNo||String||非必须||页号(不传默认为1)||
||pageSize||String||非必须||每页显示多少条数据(不传默认为1000,最小值为1,最大值为1000)||
[[BR]]返回结果:
[[BR]]{"code":-1,"message":"登录后才能操作!"}
[[BR]]{"code":-1,"message":"请输入正确的siteId"}[[BR]]
{
articleList: [
{
collectid: "142734", //收藏id[[BR]]
id: "2048279", //文章id[[BR]]
image: "http://img0.pcauto.com.cn/pcauto/1208/14/g_2048279_1344900311845.jpg", [[BR]]
image2: "",[[BR]]
preView: "雪铁龙对新世嘉相当重视,厂家甚至将它看成是一款全新换代车型。而新车究竟新在哪里?", [[BR]]
pubDate: "2012-08-14", [[BR]]
tags: "世嘉;雪铁龙;东风雪铁龙", [[BR]]
title: "雪铁龙新世嘉评测 主要的变化来自外观", [[BR]]
topicUrl: "http://roadtest.pcauto.com.cn/yc/1207/2048279.html", [[BR]]
url: "http://www.pcauto.com.cn/pingce/yc/1207/2048279.html" [[BR]]
},......
]
}
=== 3.1 [=#point3.1 找车] ===
=== 3.1.1 [=#point3.1.1 车系车型图片筛选条件] ===
(接口已完成,测试请连web开发机代理)
请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0&colorId=0&typeId=0&v=4.6.0
[[BR]]后端地址:
[[BR]]请求方式:GET
[[BR]]是否需要登录:否
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialId||string||必须||车系id||
||modelId||string||可选||车型id,查车系的时候不用传||
||colorId||string||可选||颜色id,查全部颜色的时候不用传||
||typeId||string||可选||类型id,查全部类型得时候不用传||
||v||string||可选||v=4.6.0,4.6版本使用新的后端接口:http://price.pcauto.com.cn/interface/iphone/photo_choose_option_linkage.jsp,v=4.5.0或不填则使用旧接口:http://price.pcauto.com.cn/interface/iphone/photo_choose_option.jsp||
||cateId||string||可选||细分类型id,当v=4.6.0时选细分项,与typeId一起传||
[[BR]]
返回结果:[[BR]]
{{{
{
colors: [
{
count: "479",
id: "44908",
isMetal: "0",
name: "平安白",
value: "(245,245,245)"
}
],
models: [
{
count: "91",
id: "34205",
name: "2015款 1.4 手动 舒适版"
}
],
types: [
{
id: "1",
name: "外观",
section: [
{
id: "1",
name: "全部"
}
]
}
]
}
}}}
[[BR]]
=== 3.1.2 [=#point3.1.2 车型综述页] ===
(接口已完成,测试请连web开发机代理)
请求url:http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=28350,32262&v=4.6.0
[[BR]]说明:
{{{
客户端4.5版本的请求url:http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=28350,32262
客户端4.6新增一个跳转协议,为了不影响4.5版本使用,4.6需要使用新版本接口
}}}
[[BR]]新增协议如下:
[[BR]]点击竞争车型协议pcautobrowser://model/30499?serialId=(车系id) 30499为车型id
=== 3.1.3 [=#point3.1.3 热门品牌] ===
(接口已完成上线,品牌可从madmin.pconline.com.cn的管理配置pcauto_hot_brands中修改)
[[BR]]请求url:http://mrobot.pcauto.com.cn/configs/pcauto_hot_brands
[[BR]]后端地址:无
[[BR]]请求方式:get
[[BR]]是否需要登录:否
[[BR]]返回格式:JSON
[[BR]]缓存方式:无
[[BR]]缓存时间:0
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
无
[[BR]]返回结果:
{{{
"brands": [
{
"id": 2,
"letter": "D",
"logo": "http://www1.pcauto.com.cn/piclib/2.png",
"name": "大众"
},
{
"id": 10,
"letter": "F",
"logo": "http://www1.pcauto.com.cn/piclib/10.png",
"name": "丰田"
},
……
]
}}}
=== 3.1.4 [=#point3.1.4 条件筛选增加产地] ===
(接口已完成,测试请连web开发机代理)
[[BR]]说明:找车条件筛选新增产地这个选项
[[BR]]请求url:
{{{
(1)http://mrobot.pcauto.com.cn/buy/price/chooseOption
(2)http://mrobot.pcauto.com.cn/buy/price/search该接口采用新的接口,不再调用buy/price/search(此接口用于入报价),现在调用http://mrobot.pcauto.com.cn/v3/price/chooseOptionLink(参数不变)
(3)http://mrobot.pcauto.com.cn/v3/price/search
}}}
[[BR]]后端地址:
(1)http://price.pcauto.com.cn/interface/iphone/price_choose_option.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是:http://dev3.pcauto.com.cn:8001)
(2)http://price.pcauto.com.cn/interface/iphone/price_choose_option_linkage.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是:http://dev3.pcauto.com.cn:8001)
(3)http://price.pcauto.com.cn/interface/iphone/query_serial_group.jsp?carf=4&pl=5&jb=71&qdfs=2&pe=62&pz=7&ps=0(测试地址是:http://dev3.pcauto.com.cn:8001)
[[BR]]请求方式:get
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||jb||int||否||76、110、73、72、71、70、111、74、75、131、132、133、134、135、112、77、93、105、94级别[[BR]]
||pl||int||否||1到7排量 [[BR]]
||bsx||int||否||1到8、9999变速箱[[BR]]
||country||int||否||1到13国别 [[BR]]
||mkid||int||否||4、1、6、8、113、50、61、60、2、7、123、124、9999车身结构 [[BR]]
||qdfs||int||否||1到3 驱动方式[[BR]]
||jq||int||否||1到4 进气方式[[BR]]
||carf||int||否||2到4 产地[[BR]]
||rl||int||否|| 1到4燃料[[BR]]
||zw||int||否||4到8 座位数[[BR]]
||pz||int||否||1到15 配置[[BR]]
||ps||float||否|| 自定义最低价[[BR]]
||pe||float||否|| 自定义最高价[[BR]]
[[BR]]返回结果:
{
"data": [
{
"groupTotal": 496
}
],
"fact": [
{
"field": "jb",
"items": [
"76",
"110",
"73",
"72",
"71",
"70",
"75",
"131",
"132",
"133",
"134",
"135",
"75",
"74",
"111",
"112",
"77",
"105",
"94",
"112"
].....
}
}
]
}
[[BR]]
=== 4.1 [=#point4.1 个人中心] ===
=== 4.1.1 [=#point4.1.1 获取系统消息] ===
(接口已完成,测试请连web开发机代理)
[[BR]]说明:需要新版本接口,因为4.5要过滤a标签,4.6不需要过滤
[[BR]]原请求url:http://mrobot.pcauto.com.cn/v3/bbs/getSysNotice?status=-1&pageSize=20&pageNo=1&common_session_id=DA4C99E3FDF2FDE541D7A9319891798C2DD2AFCE4E6EEB28
[[BR]]后端地址:http://bip.pcauto.com.cn/intf/sysnotice.jsp
[[BR]]请求方式:GET
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||status||string||必须||-1为已读和未读,0表示未读,1表示已读||
||common_session_id||string||必须|| 登录session||
||v||string||可选|| 4.6.0表示4.6版本,不过滤标签||
||pageNo||string||可选||页码||
||pageSize||string||可选||一页条数,默认20,最大500||
[[BR]]
返回结果:[[BR]]
{{{
{
pageCount: 1,
pageNo: 1,
pageSize: 20,
resultList: [
{
accountId: 33375426,
content: "年底抢楼送大奖,说出对新年愿望祝福——送儿童安全座椅、投影机、行车记录仪、京东购物卡、移动电源!!!http://bbs.pcauto.com.cn/topic-5955076.html",
createTime: 1417500858000,
groupSend: 1,
groupType: 0,
id: 124624885,
senderId: 0,
siteId: 2,
status: 1,
type: {
groupType: 1,
id: 0,
name: "系统消息",
siteId: 0,
templateId: 0
},
typeId: 41
}
],
total: 13
}
}}}
[[BR]]
content字段的跳转内容加上html标签,客户端做识别和跳转
[[BR]]
=== 4.1.2 [=#point4.1.2 获取个人信息] ===
(接口已完成,测试请连web开发机代理)
[[BR]]说明:4.6用到新版本后端接口
[[BR]]请求url:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo?uid=12355&v=4.6.0
[[BR]]后端地址:(4.6前)http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp
[[BR]]后端地址:(4.6)http://bbs.pcauto.com.cn/admin.do/appapi/1/user/getUserByUid.do?req_enc=utf8&resp_enc=utf8
[[BR]]请求方式:GET
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||uid||string||必须||用户id||
||v||string||可选|| 4.6.0表示4.6版本,采用新接口||
[[BR]]
返回结果:[[BR]]
{{{
{
address: "",
birthday: "",
brandId: 0,
brandName: "",
cityId: 0,
cityName: "",
common_session_id: "E7517152E962F243B967BE9FC50A5609243CF83D43FDB536",
fans: 0,
friends: 0,
image: "http://i1.3conline.com/images/upload/upc/face/12/35/5/12355_100x100",
isVip: false,
level: "",
name: "",
nickname: "12355",
phoneNum: "",
provinceId: 0,
provinceName: "",
realName: "",
serialId: 0,
serialName: "",
sex: 0,
userId: 12355,
zipCode: ""
}
}}}
[[BR]]content字段的跳转内容加上html标签,客户端做识别和跳转
=== 5.1 [=#point5.1 优惠] ===
=== 5.1.1 [=#point5.1.1 优惠降价列表] ===
(接口已完成,测试请连web开发机代理)
[[BR]]请求url:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange
[[BR]]HTTP请求方式:GET
[[BR]]是否需要登录:false
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]说明:增加价格区间和级别的筛选条件
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||areaId||string||必须||地区id(默认1)||
||brandId||string||可选||品牌id(默认0)||
||serialId||string||可选||车系id(默认0)||
||modelId||string||可选||车型id(默认0)||
||orderBy||string||可选||popularity, newest, discountRange, lowestPrice;分别指按车型热度,按最新,按降价幅度,按最低价格||
||ps||string||可选||最低价格,如13,单位万元 (默认-1)||
||pe||string||可选||最高价格,单位万元(默认0)||
||jb||string||可选||级别,如71(默认0)||
[[BR]]返回结果:
{{{
{
"data": [
{
"area": "广州",
"createTime": 1406602096000,
"dealerId": "45742",
"dealerName": "进口大众广州鸿众",
"dealerNewsId": "5154551",
"dealerType": "综合店",
"decline": "35.0",
"discount": "163400",
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/01/c8/24016521_1375350331166_350x260.jpg",
"is400": "1",
"isShow24Icon": 1,
"modelId": "32583",
"modelName": "高尔夫(进口) 2014款 2.0 TSI R敞篷版",
"modelPrice": "46.68",
"phone": "400-860-0819",
"price": "30.34",
"serialGroupId": 4391,
"serialGroupName": "高尔夫(进口)"
}
],
"pageNo": 1,
"pageSize": 20,
"total": 6559
}
}}}
=== 6.1 [=#point6.1 论坛] ===
=== 6.1.1 [=#point6.1.1 帖子页] ===
(接口已完成,测试请连web开发机代理)
[[BR]]'''获取文章或者帖子内容:'''
[[BR]]请求URL:http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.5.0&app=pcautobrowser&size=18
[[BR]]HTTP请求方式:get
[[BR]] 是否需要登录:否
[[BR]] 返回格式:html页面
[[BR]] 缓存方式:无
[[BR]] 缓存时间:无
[[BR]] 请求参数:
[[BR]] 帖子ID
[[BR]] pageNo:页码
[[BR]] pageSize:一页条数
[[BR]] picRule:获取图片的网络访问方式
[[BR]] authorId:作者ID
[[BR]] topicTemplate=4.0.0
[[BR]] app=pcautobrowser
[[BR]] size:字体大小
[[BR]] mode:阅读模式:无参数 白天;night 晚间
[[BR]]请求后端URL:
[[BR]] http://bbs.pcauto.com.cn/rest/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
[[BR]] 请求后端参数:
[[BR]] pageNo:页码
[[BR]] pageSize:一页条数
[[BR]] picRule:获取图片的网络访问方式
[[BR]] authorId:作者ID
[[BR]] topicTemplate=4.0.0
[[BR]] app=pcautobrowser
[[BR]] size:字体大小[[BR]]
[[BR]]'''获取帖子在个人中心的收:id:'''
[[BR]] 请求后端URL:
[[BR]] http://bbs.pcauto.com.cn/action/user/check_favorite.jsp
[[BR]]请求后端参数:
[[BR]] tid:4592911
[[BR]]'''4.6版本加了回复之后的调用函数:addComments(postId,topicId);///////postId是新回复后新生成的postId,topicId是文章id,调用后会原页面最下端新加一个回复数据。'''
[[BR]]'''页面加入2个广告位,一个是文字信息,一个是图片信息'''
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]] 相应在文字那里,客户端插入eg:东风日产全新蓝鸟5.0全新上市敬请推广
[[BR]] 图文广告,客户端插入eg:
推广
== 3.车型库+商城优化的接口列表 ==
=== 3.1 [=#point3.1 索引表] ===
(接口开发完成,测试请连测试机代理)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/list_dealer_news_city_relation?areaId=1
[[BR]]原接口:http://openvr.pcauto.com.cn/iphone/atom/relation/{areaId}.txt
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:30分钟
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||areaId||String||是||地区id||
[[BR]]返回结果:
{{{
{
"serial_dealer": [
3745 //该地区有经销商的车系ID
],
"serial_news": [
4450 //该地区有促销信息的车系ID
],
"model_dealer":[17277], //该地区有经销商的车型ID
"model_news": [
34943, //该地区有促销信息的车型ID
25322
]
}
}}}
=== 3.2 [=#point3.2 车系综述页] ===
(接口开发完成,测试请连测试机代理,4.6xsp架构,请求url需修改)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/serialsv46.xsp?serialId=3544®ionId=1&hasDealers=1&modelIds=34224,34226
[[BR]]原接口:
{{{
http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=3544
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_local_min_price.jsp?mid=20208&rid=117
http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=3544&size=3
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=3544
http://price.pcauto.com.cn/interface/iphone/get_serialGroup_dealerCount.jsp?serialGroupId=3544&rid=1
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId=3544&rId=1
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:1分钟
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialId||String||必须||车系Id||
||regionId||String||必须||地区Id||
||hasDealers||String||可选||取值1表示该车系在该地区有经销商||
||modelIds||String||可选||对比车型Id,逗号分隔||
[[BR]]返回结果:html页面
=== 3.3 [=#point3.3 车型综述页] ===
(接口开发完成,测试请连测试机代理,4.6xsp架构,请求url需修改)
[[BR]]mrobot请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/modelsv46.xsp?mid=34626&areaId=1&hasDealers=1&modelIds=25157,34574
[[BR]]原接口:
{{{
车型概览接口 http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid=20208
车型本地最低价接口 http://price.pcauto.com.cn/interface/iphone/model_local_min_price.jsp?mid=20208&rid=117
地区经销商数据 http://dev3.pcauto.com.cn:8001/interface/iphone/dealer_page_list_json.jsp?modelId=3544&pageNo=1&pageSize=10&rId=1
竞争车型,带价格信息 http://price.pcauto.com.cn/interface/iphone/model_compete.jsp?mid=20208&version=2&rid=1 (不带价格信息 http://price.pcauto.com.cn/interface/iphone/model_compete.jsp?mid=20208)
团购信息 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=933&callback=list
}}}
[[BR]]HTTP请求方式: Get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60min
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||mid ||String||必须||车型id||
||areaId||String||必须||地区id||
||hasDealers||1,0||必须||1是有经销商,0是没有经销商||
||modelIds||String||可选||对比车型id||
||night||String||可选||是否夜间模式||
[[BR]]返回结果:
=== 3.4 [=#point3.4 车系车型优惠列表] ===
(接口开发完成,测试请连测试机代理)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange&serialId=3225
[[BR]]原接口:http://price.pcauto.com.cn/dealer/interface/app/market_json.jsp
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:无
[[BR]]缓存时间:15分钟
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||参数名||类型||必须||说明||
||areaId||string||必须||地区id(默认1)||
||brandId||string||可选||品牌id(默认0)||
||serialId||string||可选||车系id(默认0)||
||modelId||string||可选||车型id(默认0)||
||orderBy||string||必须||popularity, newest, discountRange, lowestPrice;分别指按车型热度,按最新,按降价幅度,按最低价格||
||ps||string||可选||最低价格,如13,单位万元 (默认-1)||
||pe||string||可选||最高价格,单位万元(默认0)||
||jb||string||可选||级别,如71(默认0)||
[[BR]]返回结果:
{{{
{
"data": [
{
"area": "广州",
"createTime": 1406602096000,
"dealerId": "45742",
"dealerName": "进口大众广州鸿众",
"dealerNewsId": "5154551",
"dealerType": "综合店",
"decline": "35.0",
"discount": "163400",
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/01/c8/24016521_1375350331166_350x260.jpg",
"is400": "1",
"isShow24Icon": 1,
"modelId": "32583",
"modelName": "高尔夫(进口) 2014款 2.0 TSI R敞篷版",
"modelPrice": "46.68",
"phone": "400-860-0819",
"price": "30.34",
"serialGroupId": 4391,
"serialGroupName": "高尔夫(进口)"
}
],
"pageNo": 1,
"pageSize": 20,
"total": 6559
}
说明:dealerNewsId,行情id,请求“2.8.23 优惠详情”页面时的请求参数;
discount,降价幅度。
}}}
=== 3.5 [=#point3.5 促销优惠终端页] ===
(接口开发完成,测试请连测试机代理)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/promotionDetailv45/{id}?modelId=33314&type=1
[[BR]]例如:http://mrobot.pcauto.com.cn/v3/price/promotionDetailv45/7033340?modelId=33314&type=1
[[BR]]原接口:http://dev3.pcauto.com.cn:8001/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId=7033340&modelId=33314(优惠基础信息)
[[BR]]原接口:http://dev3.pcauto.com.cn:8001/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId=7033340(关联车型接口)
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||id||String||必须||优惠行情id||
||type||String||可选||请求的优惠页样式:type=0指请求车系降价列表的优惠页;type=1指请求经销商详情优惠列表的优惠页||
||modelId||String||可选||车型id,type=0的时候需要传此参数||
[[BR]]返回结果:
=== 3.6 [=#point3.6 活动列表] ===
(接口开发完成,测试请连测试机代理)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/activityListv45/1?pageNo=1&pageSize=20
[[BR]]原接口:http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=1
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:无
[[BR]]缓存时间:15分钟
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||areaId||int||是||城市ID||
||manufacturerId||int||否||车厂ID||
||pageNo||int||否||第几页,默认第1页||
||pageSize||int||否||显示条数,默认20||
[[BR]]返回结果:
{
"data": [
{
"banner": "http://img.pconline.com.cn/images/upload/upc/tx/tuangou/1411/14/c0/34350_1415973025778_500x200.jpg", //购车团主图500x200px
"beginTime": "2014/11/14 00:00:00", //开始时间
"brandName": "凯迪拉克(进口)", //车厂名称
"endTime": "2014/12/12 23:59:59", //结束时间
"id": 349, //购车团ID
"maxDiscount": 5, //最高优惠,单位万.
"orderCount": 2, //活动报名人数
"photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1403/18/c3/32200468_1395112948222_180x135.jpg", //最大优惠车系主图,180x135像素
"priceTitle": "最高优惠", //价格标题
"serialGroupNames": "凯迪拉克SRX", //车系名称串(最多5个)
"title": "凯迪拉克厚惠无欺 万元优惠超值惊喜", //购车团标题
"url": "http://dev3.pcauto.com.cn:9977/gct/r3/g349/" //购车团链接
}
],
"pageCount": 14, //总页数
"pageNo": 1, //页码
"pageSize": 1, //页面条数
"total": 14 //总条数
}
=== 3.7 [=#point3.7 活动详情页] ===
(接口开发完成,测试请连测试机代理,4.6xsp架构,请求url需修改)
[[BR]]mrobot请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/activityDetailv46.xsp?tuanId=421&areaId=4
[[BR]](旧接口:http://mrobot.pcauto.com.cn/v3/price/activityDetailv45/552?areaId=1&serialId=0&modelId=0&name=&tel=&dId=d5d5ceb98978c614d82e578320e1fce6c0e2bea9)
[[BR]]原接口:
{{{
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_detail_json.jsp
http://price.pcauto.com.cn/dealer/interface/tuangou/dealer_serialgroup_photo_json.jsp
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_models_json.jsp
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_dealers_json.jsp
http://price.pcauto.com.cn/interface/cms/region_400_json.jsp
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||tuanId||String||Y||团购id||
||areaId||String||Y||地区id||
[[BR]]返回结果:
=== 3.8 [=#point3.8 车系经销商] ===
(接口开发完成,测试请连测试机代理)
mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv45?serialId=4550&areaId=1
[[BR]]原接口:http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4550(第一款车型)
[[BR]]原接口:http://price.pcauto.com.cn/interface/iphone/dealer_page_list_json.jsp?serialGroupId=4550&rId=1&pageSize=60&pageNo=1(经销商列表)
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:1小时
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialId||String||必须||车系Id||
||areaId||String||必须||地区Id||
||pageSize||String||可选||每页条数||
||pageNo||String||可选||页码||
[[BR]]返回结果:html
=== 3.9 [=#point3.9 地区选择接口] ===
(接口开发完成,测试请连测试机代理)
[[BR]]mrobot请求url:http://mrobot.pcauto.com.cn/v2/cms/area_tree
[[BR]]原接口:http://price.pcauto.com.cn/interface/iphone/province_city_list.jsp
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:1天
[[BR]]说明:接口返回数据比4.5版本新增了省份id
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||order||String||可选||带参数order=alpha排序,没有参数不排序||
[[BR]]返回结果:
{{{
{"area":[[
"468", //城市id
"天水", //城市名称
"5401", //计数id
"甘肃", //省名
"天水市", //城市名
"25" //省份id
],......
]}
}}}