[[TOC]]

== 1.基本约定 ==
{{{
web开发机代理：192.168.10.199 端口为 1080

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
||参数名||类型||必须||说明||
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是|否
返回格式：json|xml|ssi,
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况
}}}


== 2.接口列表 ==
=== 2.1 [=#point2.1 资讯] ===
=== 2.1.1 [=#point2.1.1 文章收藏批量操作] ===
请求url:
[[BR]]后端地址:
[[BR]]请求方式:
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
[[BR]]返回结果:
=== 2.1.2 [=#point2.1.2 获取账号的收藏文章] ===
请求url:
[[BR]]后端地址:
[[BR]]请求方式:
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
[[BR]]返回结果:
=== 2.1.3 [=#point2.1.3 视频文章终端页] ===
请求url:
[[BR]]后端地址:
[[BR]]请求方式:
[[BR]]是否需要登录:是
[[BR]]返回格式:JSON
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:60分钟
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
[[BR]]返回结果:
=== 3.1 [=#point3.1 找车] ===
=== 3.1.1 [=#point3.1.1 车系车型图片筛选条件] ===
请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0&colorId=0&typeId=0&v=4.5.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.5.0  4.5版本增加类型细化，颜色值||
[[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 车型综述页] ===
请求url：
[[BR]]说明：
[[BR]]客户端4.5版本的请求url：http://mrobot.pcauto.com.cn/v3/price/modelsv45/${modelId}?areaId=1&modelIds=modelIds=28350,32262
[[BR]]客户端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]]缓存时间:30分钟
[[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": "丰田"
               },……
               ]

=== 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版本，不过滤<a>标签||
||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标签，客户端做识别和跳转
=== 5.1 [=#point5.1 优惠]  ===
=== 4.1.1 [=#point4.1.1 优惠降价列表] ===
（接口开发完成已上线）
[[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||
||brandId||string||可选||品牌id||
||serialId||string||可选||车系id||
||modelId||string||可选||车型id||
||orderBy||string||必须||popularity, newest, discountRange, lowestPrice；分别指按车型热度，按最新，按降价幅度，按最低价格||
||ps||string||可选||最低价格，如13，单位万元||
||pe||string||可选||最高价格，单位万元||
||jb||string||可选||级别，如71||
[[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
}