[[TOC]]

== 1.基本约定 ==
mrobot开发机代理：192.168.10.199 端口为 1080
[[BR]]mrobot测试机代理：192.168.10.198 端口为 1080

== 2.接口列表 ==
=== 2.1 [=#point2.1 首页列表（增加广告类信息）] ===
[[BR]]（接口已完成，测试请连web开发机代理）
[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0
[[BR]]后端接口：
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:返回的头条文章增加isExtend字段，isExtend=1表示推广，=0或无表示不推广，可在madmin后台编辑头条文章配置；当isExtend=1时，type=0
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||pageNo||string||可选||页码||
||pageNo||string||可选||每页数据||
||v||string||可选||v=4.0.0出4.0版本后的数据格式||
[[BR]]返回数据结构:
{{{
{
data: [],
focus: [],
pageNo: 1,
pageSize: 20,
topData: [
{
channelName: "",
downs: 0,
image: "45345354",
isExtend: "0",
preView: "345345345",
pubDate: "2012-01-01",
seq: 1,
title: "4545454",
to-uri: "pcautobrowser://model/",
type: 0,
updateAt: 1425484800000,
ups: 0
},...
}
}}}

=== 2.2 [=#point2.2 车系综述页（json、日志功能）] ===
（接口开发完成，测试请连开发机代理)
[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/serialsv46.xsp?serialId=3895&regionId=1&hasDealers=1&fmt=json
[[BR]]此接口请求头部新增三个参数：Udid（设备标识），Version（应用版本号），App（应用名称：PCAUTO_INFO_iOS/android）
[[BR]]后端接口：
{{{
http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=3895
http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=3895
http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=3895&size=3
http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=3895
http://price.pcauto.com.cn/interface/iphone/get_serialGroup_dealerCount.jsp?serialGroupId=3895&rid=1
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId=3895&rId=1
}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:接口缓存
[[BR]]缓存时间:1分钟
[[BR]]说明:fmt=json时出json格式，否则出页面
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||serialId||String||必须||车系Id||
||regionId||String||必须||地区Id||
||hasDealers||String||可选||取值1表示该车系在该地区有经销商||
||modelIds||String||可选||对比车型Id，逗号分隔||
||fmt||String||可选||fmt=json时出json格式，否则出页面||
[[BR]]返回数据结构:
{{{
{
sgAverageScore: 4.3,
structure: "SUV",
manufacturerId: "5",
bbsId: "16735",
gearbox: "手动 手自一体",
brandId: "2",
photo: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1502/05/c31/2780600_2780600_1423129144593_120x90.jpg",
kind: "紧凑型SUV",
photo_400x300: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1502/05/c31/2780600_2780600_1423129144593_400x300.jpg",
priceRange: "19.98~31.58万",
advantage: "做工优秀，驾驶性能突出，动力总成先进",
manufacturer: "上海大众",
displacement: "1.4T 1.8T 2.0T",
shareUrl: "http://price.pcauto.com.cn/sg3895/",
photoTotal: 5156,
brand: "大众",
serialGroupName: "途观",
disadvatage: "内饰设计过于平庸，涡轮反应迟滞",
serialId: "3895",
isGDA: null,
city: "广州",
dealerCount: 9,
salesStops: 1,
sales: [],
saleStops: [],
saleUpcomming: [ ],
competeSerials: {}
}
}}}
=== 2.3 [=#point2.3 车型综述页（日志功能）] ===
[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/modelsv46.xsp?mid=36966&areaId=1&hasDealers=1
[[BR]]此接口请求头部新增三个参数：Udid（设备标识），Version（应用版本号），App（应用名称：PCAUTO_INFO_iOS/android）
[[BR]]其他保持不变
=== 2.4 [=#point2.4 车系综述页（tab栏交互优化）] ===
（接口开发完成，测试请连开发机代理)
[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.6/serialsv46.xsp?serialId=3895&regionId=1&hasDealers=1
[[BR]]此接口请求头部新增三个参数：Udid（设备标识），Version（应用版本号），App（应用名称：PCAUTO_INFO_iOS/android）
[[BR]]制作地址：http://192.168.33.223/20150227%20app4.7.0.B150302/plan.html
[[BR]]说明：此接口返回页面“在售/停售”tab栏交互优化，其他保持不变
=== 2.5 [=#point2.4 车系点评页（tab栏交互优化）] ===
（接口开发完成，测试请连开发机代理)
[[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v3/price/serialCommentList/3895
[[BR]]制作地址：http://192.168.33.223/20150227%20app4.7.0.B150302/plan.html
[[BR]]说明：此接口返回页面“在售/停售”tab栏交互优化，其他保持不变