1.基本约定
1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。
2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。
{
"uri" : "/intf/albums-by-type.jsp",
"error-desc":"Need you follow uid.",
"user-notice":"给用户的提示放在这里"
}
3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码:
String queryString = request.getQueryString();
String requestEncoding = getParam(queryString,"req_enc");
String responseEncoding = getParam(queryString,"resp_enc");
if(isNotBlank(requestEncoding)){
request.setCharacterEncoding(requestEncoding);
}
if(isNotBlank(responseEncoding)){
response.setCharacterEncoding(responseEncoding);
}
4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。
5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。
6.需要登录的接口,cache-control=600 ;分开优先级低和主动请求两种,前者用cacheFirst,后者用noCache
2.接口列表
2.1 左侧主菜单
url:madmin 配置项:pcauto_left_menu
作用:左侧主菜单
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:否
请求参数:none
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye/page.html
返回参数:
[
{
"id":1,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"首页",
"view":"information-home/",
"url":"http://www.baidu.com"
},
{
"id":2,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"降价",
"view":"more/",
"url":"http://www.baidu.com"
},
{
"id":3,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"找车",
"view":"brand-list/",
"url":""
},
{
"id":4,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"论坛",
"view":"bbs-home/",
"url":""
},
{
"id":5,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"行情",
"view":"more/",
"url":"http://www.baidu.com"
},
{
"id":6,
"img":"http://img0.pcauto.com.cn/pcauto/1310/16/3233041_Img388290093_thumb.jpg",
"title":"图集",
"view":"album-list/",
"url":""
}
]
2.2 默认订阅栏目
url:madmin 配置项:pcauto_home_default_subscription_channels
作用:获取默认订阅的栏目
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:否
请求参数:none
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html
返回参数:
{
"serials": [
{
"id": 3404,
"name": "福克斯"
},
{
"id": 2143,
"name": "蒙迪欧"
}
]
}
2.3 头条
url:
作用:获取头条数据,
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:否
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html
请求参数:
pageSize
pageNo
serialIds // 已经订阅的车系id,逗号分割
返回参数:
"pageNo":1,
"pageSize":20,
"total":300, // 栏目内容总数,最多300条
"contents": [
{
"count": 93, // 如果是文章则为评论数,如果是帖子则为楼层数,如果是图集则为图片张数
"id": 2965125, // 文章、帖子或者图集id
"type":"", // 类型,目前包含article, album和topic三个值
"img": "http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg", //导读图
"title": "[直播]成都车展探馆:奥迪RS5 Coupe亮相", //内容标题
"chl":"所属栏目" // 所属栏目,指3.6.0mrobot整理的栏目
"ups":123, // 赞的数量
"downs":123 // 踩的数量
},
...
],
"focus":[
{
"img:":"http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg",
"id":111111 // 同上
}
],
topContents:[], // 规则按照http://mrobot.pcauto.com.cn/v2/cms/channels/1里的topArticles,车系聚合里没有这个字段
topFocus:[] // 规则按照http://mrobot.pcauto.com.cn/v2/cms/channels/1里的topFocus,车系聚合里没有这个字段
2.3.1 车系聚合页
url:http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/8670(已经订阅的车系id)
作用:获取车系聚合页数据
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:否
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html
请求参数:
pageSize
pageNo
返回参数:
{
"pageNo":1,
"pageSize":20,
"total":300, // 栏目内容总数,最多300条
"resultList": [
{
"count": 93, // 如果是文章则为评论数,如果是帖子则为楼层数
"id": 2965125, // 文章、帖子
"type":"", // 类型,目前包含article和topic三个值
"image": "http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg", //导读图
"title": "[直播]成都车展探馆:奥迪RS5 Coupe亮相", //内容标题
"channel":"所属栏目", // 所属栏目,指3.6.0mrobot整理的栏目
"ups":123, // 赞的数量
"downs":123 // 踩的数量
}
]
}
=== 2.4 [=#point204 赞和踩]===
{{{
url:
汽车网:待定
作用:对某个对象赞或者踩
使用范围:汽车网app
备注:该接口需要防止刷数据
HTTP请求方式:post
是否需要登录:否
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye%20-%20daohang/page.html
请求参数:
id,文章、帖子或者图集id
type,article、topic或者album
action,up或者down,分别代表赞和踩
返回参数:
{
"id":123 // 文章、帖子或者图集id
"type":"article", // article、topic或者album
"resultCode":0, // 0表示成功,其他是失败
"msg":"提示信息", // 提示信息
"ups":123, // 赞的数量
"downs":123 // 踩的数量
}
}}}
=== 2.5 [=#point205 搜索栏目文章]===
{{{
url:http://mrobot.pcauto.com.cn/v2/cms/channels/2?serialIds=3524
作用:点击文章终端的栏目按钮,出该车系的栏目文章
使用范围:汽车网app
备注:添加serialIds,在原来的基础上过滤出属于该车系的文章
HTTP请求方式:get
是否需要登录:否
请求参数:
serialId:车系id,可选参数
返回参数:
参考3.6.0的栏目接口 http://mrobot.pcauto.com.cn/v2/cms/channels/2
}}}
=== 2.6 [=#point206 新消息]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount
作用:获取个人中心的新消息的数量
使用范围:汽车网app
备注:提醒包含一下几种
1.我发的帖子,别人回帖
2.我发的回帖,别人回复
3.我发的文章评论,别人回复
HTTP请求方式:get
是否需要登录:是
请求参数:
common_session_id:用户登陆后获得的认证id
返回参数:
messageCount:短消息(站内信、私信)
systemNoticeCount:系统消息(例如删帖提示、设置精华提示等等)
fansCount:关注消息
forumReplyCount:论坛消息(包括别人对我发的帖子的回帖和别人对我的回帖的回复)
commentReplyCount:文章评论消息
carReplyCount:车主点品消息
提醒 = forumReplyCount + commentReplyCount
}}}
=== 2.7 [=#point207 您可能对以下内容感兴趣]===
{{{
url: madmin配置项:pcauto_hot_serials,与[2.38 车型库首页热门车系列表]相同
作用:获取可能感兴趣内容
使用范围:汽车网app
备注:madmin配置项
设计稿:http://192.168.50.175/work/201309/pcauto4.0/shouye/page.html
HTTP请求方式:get
是否需要登录:否
请求参数:
返回参数:
{
"manufacturers": [
{
"name": "热门车系",
"serials": [
{
"id": 9550,
"name": "奥迪A3",
"kind": "紧凑型车",
"priceRange": "null",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg",
"count": 0
},
{
"id": 8670,
"name": "奥迪Q3",
"kind": "中型SUV",
"priceRange": "28.5~42.88 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8670.jpg",
"count": 6
},
{
"id": 4313,
"name": "奥迪A6L",
"kind": "中大型车",
"priceRange": "38.3~74.26 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4313.jpg",
"count": 59
},
{
"id": 4457,
"name": "奥迪Q5",
"kind": "中大型SUV",
"priceRange": "35.85~56.77 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4457.jpg",
"count": 20
},
{
"id": 3524,
"name": "奥迪A4L",
"kind": "中型车",
"priceRange": "27.28~57.81 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
"count": 32
}
]
}
]
}
}}}
=== 2.8 [=#point208 收藏夹信息---文章]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles/826717?pageNo=1&pageSize=20
作用:收藏夹信息---文章
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html
请求参数:
common_session_id,
用户id,
pageNo,
pageSize
返回参数:
{
"pageNo": 1,
"pageSize": 20,
"total": 300,
"articleList": [
{
"id": 2965125, //文章id
"img": "http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg",//导读图
"title": "[直播]成都车展探馆:奥迪RS5 Coupe亮相",//标题
"channel": "导购",//所属栏目
"cmtCount": 57,
"ups": 123,//赞的数量
"downs": 123//踩的数量
},
{
"id": 3229359,
"img": "http://img0.pcauto.com.cn/pcauto/1310/16/g_3229359_1381886137401_240x160.jpg",
"title": "2014款长安CX20正式上市 售5.59-6.49万",
"channel": "新车",
"cmtCount": 57,
"ups": 12,
"downs": 13
}
]
}
}}}
=== 2.9 [=#point209 收藏夹信息---帖子]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20
作用:收藏夹信息---帖子
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html
请求参数:
common_session_id,
用户id,
pageNo,
pageSize
返回参数:
{
"pageNo": 1,
"pageSize": 20,
"total": 300,
"topicList": [
{
"id": 82360,
"topicId": 3811550,
"name": "首保时,4S给换的机油如何??",
"ups": 12,
"downs": 13,
"forumName": "飞度论坛"
},
{
"id": 81758,
"topicId": 2536517,
"name": "【活动报道】全新奥迪A8L上市品鉴会",
"ups": 12,
"downs": 13,
"forumName": "奥迪A8L论坛"
}
]
}
}}}
=== 2.10 [=#point210 收藏夹信息---车型]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getCars/1?pageNo=1&pageSize=20
作用:收藏夹信息---车型
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html
请求参数:
common_session_id,
pageNo,
pageSize
返回参数:
{
"pageNo": 1,
"pageSize": 20,
"total": 300,
"modelList": [
{
"id": 259356,//爱车id
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1209/25/c1/14124013_14124013_1348553959703_270x202.jpg",
"modelId": 22479,
"name": "昂科拉ENCORE 2013款 基本型",//车型名称
"price": "20万",
"serialName": "昂科拉ENCORE"//车系名称
},
{
"id": 259355,
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1212/16/c3/16652316_16652316_1355659836838_270x202.jpg",
"modelId": 23395,
"name": "大众Polo 2013款 1.6 自动 舒适版",
"price": "21万",
"serialName": "大众Polo"
}
]
}
}}}
=== 2.11 [=#point211 添加收藏]===
{{{
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html
参考http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point207
备注:添加文章收藏功能;解除车型收藏的数量限制。
}}}
=== 2.12 [=#point212 删除收藏]===
{{{
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html
参考http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point207
备注:添加文章收藏功能;解除车型收藏的数量限制。
}}}
=== 2.13 [=#point213 获取我的订阅]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getCars/0?pageNo=1&pageSize=20
作用:我的订阅
使用范围:汽车网app
备注:cache-control=600
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_Subscribe.html
请求参数:
common_session_id,
pageNo, 当pageNo=0时,直接不分页返回全部数据
pageSize
返回参数:
{
"pageNo": 1,
"pageSize": 20,
"total": 300,
"serialList": [
{
"id": 259356,//爱车id
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1209/25/c1/14124013_14124013_1348553959703_270x202.jpg",
"serialId": 22479,
"name": "昂科拉ENCORE",//车系名称
"price": "20万"
},
{
"id": 259355,
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1212/16/c3/16652316_16652316_1355659836838_270x202.jpg",
"modelId": 23395,
"name": "大众Polo",
"price": "21万"
}
]
}
}}}
=== 2.14 [=#point214 增加订阅]===
{{{
url:
汽车网:待定
作用:增加订阅
使用范围:汽车网app
HTTP请求方式:post
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_dy.html
请求参数:common_session_id,
serials,json数据,包含一个数组,数组的元素就是一款车的基本数据:
[{"id":123, "img":"", "name":"福克斯", "price":""}, ...]
返回参数:
{
"code": 1, // 1代表成功,0代表失败
"msg": "" // 结果提示
}
}}}
=== 2.15 [=#point215 删除订阅]===
{{{
url:
汽车网:待定
作用:删除订阅
使用范围:汽车网app
HTTP请求方式:post
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_Subscribe.html
请求参数:common_session_id,ids=1,2,3
返回参数:
{
"code": 1, // 1代表成功,0代表失败
"msg": "" // 结果提示
}
}}}
=== 2.16 [=#point216 获取提醒]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getgetReminds?pageSize=20&pageNo=1
作用:我的消息---提醒
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
请求参数:
common_session_id,
pageNo,
pageSize
返回参数:
{
"pageNo":1,
"pageSize":20,
"total":200,
"resultList": [
{
"id": 123123, //根据type不同而不同,为1时这是帖子id,为2时这是文章id
"type": 1,//1回复帖子,2回复评论
"face": "",
"userName": "xxx",
"userid": 6546,
"time": "2013-01-01 02:10",
"toReply": "对方回复内容",
"content": "这次的内容",
"topicId":123, // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0
"topic_url":"" , // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串
"article_title":"", // 如果这条回复是评论,则这是对应文章的标题;如果是回复帖子,为空字符串
"floor_id":123 , // 该回复的楼层id,评论和帖子都用这个字段
"floor":123 // 该回复的楼层数,评论和帖子都用这个字段
}
]
}
ps:这接口内容有3种
1.我发的帖子,别人回帖
2.我发的回帖,别人回复
3.我发的文章评论,别人回复
}}}
=== 2.17 [=#point217 删除提醒] ===
{{{
url:
汽车网:待定
作用:删除提醒
使用范围:汽车网app
HTTP请求方式:post
是否需要登录:是
请求参数:session,ids=1,2,3
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
返回参数:
{
"code": 1, // 1代表成功,0代表失败
"msg": "" // 结果提示
}
}}}
=== 2.18 [=#point218 获取私信列表]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?pageSize=20&pageNo=1
作用:我的消息---私信
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
请求参数:
common_session_id,
pageNo,
pageSize
返回参数:
{
"pageNo":1,
"pageSize":20,
"total":200,
"resultList": [
{
"face": "http://i1.3conline.com/images/upload/upc/face/24/28/68/12/24286812_50x50",
"userName": "testpcatuo",
"userId": 24286812,
"time": "2013-01-01 02:10",
"content": "b"
}
]
}
}}}
=== 2.19 [=#point219 获取个人私信]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1
作用:获取个人私信
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
请求参数:
common_session_id,
userId // 对方的用户id
返回参数:
{
"face": "http://i1.3conline.com/images/upload/upc/face/24/28/68/12/24286812_50x50",
"userName": "testpcatuo",
"userId": 24286812,
"result": [
{
"time": "2013-01-01 02:10",
"content": "这次的内容"
}
]
}
}}}
=== 2.20 [=#point220 发送私信]===
{{{
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
该接口已经上线,但是未归档,参考汽车论坛app对该接口的使用方法
}}}
=== 2.21 [=#point221 删除私信]===
{{{
url:
汽车网:待定
作用:删除私信
使用范围:汽车网app
HTTP请求方式:post
是否需要登录:是
请求参数:session,ids=1,2,3
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
返回参数:
{
"code": 1, // 1代表成功,0代表失败
"msg": "" // 结果提示
}
}}}
=== 2.22 [=#point222 我的帖子]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_posts.html
}}}
=== 2.23 [=#point223 车型库首页品牌列表]===
{{{
url:http://mrobot.pcauto.com.cn/v2/price/brands?v=4.0.0
备注:在原接口(http://mrobot.pcauto.com.cn/v2/price/brands/)基础上更改
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/zhaoche.html
作用:获取车型库品牌列表
使用范围:汽车网app
http请求方式:get
是否需要登录:否
请求参数:v=4.0.0
返回参数:在原接口返回的数据的基础上最顶层多加一个如下对象:
{
brands: [
{
hot: "奥迪A6L, 普拉多, 宝马7",
id: 0,
letter: "",
logo: "",
name: "热门车系"
}
],
index: "",
rowNum: 0
}
}}}
=== 2.24 [=#point224 精准选车条件]===
{{{
url:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0
备注:在原条件接口(http://mrobot.pcauto.com.cn/v3/price/models/criterionv36/)基础上更改
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/shaixuan.html
作用:获取选车条件
使用范围:汽车网app
http请求方式:get
是否需要登录:否
请求参数:v=4.0.0
返回参数:
1)在原接口返回数据加入变速箱条件
2)所有条件加入“不限”选项
}}}
=== 2.25 [=#point225 车主点评列表]===
{{{
url:http://mrobot.pcauto.com.cn/v3/price/getUserCommentListBySerialId/2143
作用:获取某车系下的车主点评列表
使用范围:汽车网app
是否需要登录:否
http请求方式:get
请求参数:sid:车系ID
原型图:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.0.0/iOS-v6/start.html#p=6_8user_comments
返回参数:
{
"comments": [
{
"modelId": "26845",//车型id
"modelName": "2013款2.0GTDi240旗舰型",//车型名称
"rank": "34",//在售排名
"score": "4.8",//综合评分
"price": "26.58万"//裸车均价
},
{
"modelId": "26378",
"modelName": "2013款 1.5 GTDi180 时尚型",
"rank": "90",
"score": "4.5",
"price": "19.18万"
}
]
}
}}}
=== 2.26 [=#point226 车型图片列表]===
{{{
url:车型:http://mrobot.pcauto.com.cn/v2/price/pictures?modelId=20207&fmt=json&pageSize=999&typeId=1
车系:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=4313&fmt=json&pageSize=999&typeId=1
作用:按照分类获取车型、车系图片列表
使用范围:汽车网app
是否需要登录:否
http请求方式:get
备注:与目前图集终端页使用的接口相同
}}}
=== 2.27 [=#point227 论坛帖子列表]===
{{{
url:http://mrobot.pcauto.com.cn/v3/bbs/newForums/14140
作用:获取帖子列表
使用范围:汽车网app
是否需要登录:否
http请求方式:get
设计稿:http://192.168.50.175/work/201309/pcauto4.0/luntan/luntan.html
请求参数:照旧
备注:按照4.0规定的算法排序http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/dev_requirement/sorting_algorithm;添加了ups和downs两个参数
返回参数:
{
......
"pageNo":1,
"pageSize":50,
"topicList":[
{
"author":{
"name":"yuking-ouyang",
"nickname":"yuking-ouyang",
"userId":23672097
},
"createAt":1347978864000,
"flag":"精",
"lastPoster":{
"name":"qz30446664",
"nickname":"qz30446664",
"userId":30446664
},
"replyCount":87,
"title":"8.6号新A6L30技术提车作业!!半夜的作品!!",
"topicId":3322726,
"uri":"http://bbs.pcauto.com.cn/topic-3322726.html",
"view":104676,
"ups":123,
"downs":123
},
],
......
}
}}}
=== 2.28 [=#point228 询底价页]===
{{{
需求:重新设计询底价页[[BR]]
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]]
url:待定[[BR]]
}}}
=== 2.29 [=#point229 经销商详情页]===
{{{
需求:重新设计经销商详情页[[BR]]
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]]
备注:添加预约试驾和促销信息,促销信息来自网站已有的数据,参考http://price.pcauto.com.cn/15214/news.html
url:待定[[BR]]
}}}
=== 2.30 [=#point230 车型终端页]===
{{{
需求:重新设计车型终端页;需要把同车系的所有车型都放到html里,类似文章终端的html_meta数据。[[BR]]
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/chexing.html[[BR]]
url:待定[[BR]]
}}}
=== 2.31 [=#point231 车型对比页]===
{{{
需求:更改为整个车型对比页都由HTML实现[[BR]]
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/duibijieguo.html[[BR]]
url:待定[[BR]]
}}}
=== 2.32 [=#point232 车主点评终端页]===
{{{
需求:新增页面;需要把同车系的所有车型都放到html里,类似文章终端的html_meta数据。[[BR]]
原型图:http://rdtrac.pc.com.cn/mobile/pototype/khd/v4.0.0/iOS-v6/start.html#p=6_8user_comments[[BR]]
url:待定[[BR]]
}}}
=== 2.33 [=#point233 预约驾车页]===
{{{
需求:新增页面[[BR]]
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]]
备注:咨询小虎,看提交到什么地方
url:待定[[BR]]
}}}
=== 2.34 [=#point234 车型降价信息]===
{{{
url:http://mrobot.pcauto.com.cn/v3/price/getModelfavourableInfoBySerialId/8
作用:获取某个车系下在售车型的降价信息
使用范围:汽车网app
是否需要登录:否
http请求方式:get
请求参数:sid:车系id
返回参数:
{
"models": [
{
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1211/15/c12/15782432_15782432_1352962046046_500.jpg",
"modelName": "奥迪TT 2013款 TT Roadster 2.0 45TFSI",
"city": "广州",
"dealerName": "广东粤奥",
"phone": "14929302910",
"originalPrice": "111万",//降价前的价格
"nowPrice": "121万"//降价后的价格
},
{
"image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1211/15/c12/15782432_15782432_1352962046046_500.jpg",
"modelName": "奥迪TT 2013款 TT Roadster 2.0 45TFSI quattro",
"city": "广州",
"dealerName": "广东粤奥",
"phone": "14929302910",
"originalPrice": "111万",//降价前的价格
"nowPrice": "121万"//降价后的价格
}
]
}
}}}
=== 2.35 [=#point235 文章终端json]===
{{{
url:http://mrobot.pcauto.com.cn/v3/cms/articles/3219885?fmt=json
作用:获取文章内容
使用范围:汽车网app
是否需要登录:否
http请求方式:get
请求参数:加上参数fmt=json
返回参数:按照从cms获取的原始json,加上html_meta里面的数据,整合成一个json返回
}}}
=== 2.36 [=#point236 车型库图集类别]===
{{{
url:madmin配置项:pcauto_albums_types
作用:获取车型库图集列表的类别
使用范围:汽车网app
是否需要登录:否
备注:madmin出
数据格式:
{
"types": [
{
"name": "外观",
"id": "1"
},
{
"name": "内饰",
"id": "2"
},
{
"name": "空间",
"id": "8"
},
{
"name": "其他",
"id": "3"
}
]
}
}}}
=== 2.37 [=#point237 编辑订阅列表]===
{{{
url:
汽车网:待定
作用:编辑订阅列表
使用范围:汽车网app
HTTP请求方式:post
是否需要登录:是
设计稿:http://192.168.50.213/2013.09/pcauto_4.0/auto_dy.html
请求参数:common_session_id,
serials,json数据,包含一个数组,数组的元素就是一款车的基本数据:
[{"id":123, "img":"", "name":"福克斯", "price":""}, ...]
返回参数:
{
"code": 1, // 1代表成功,0代表失败
"msg": "" // 结果提示
}
}}}
=== 2.38 [=#point238 车型库首页热门车系列表]===
{{{
url:madmin 配置项:pcauto_hot_serials
作用:车型库首页热门车系
使用范围:汽车网app
HTTP请求方式:get
是否需要登录:是
设计稿:http://192.168.50.175/work/201309/pcauto4.0/chexing/zhaoche.html
请求参数:none
返回参数:
{
"manufacturers": [
{
"name": "热门车系",
"serials": [
{
"id": 9550,
"name": "奥迪A3",
"kind": "紧凑型车",
"priceRange": "null",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_9550.jpg",
"count": 0
},
{
"id": 8670,
"name": "奥迪Q3",
"kind": "中型SUV",
"priceRange": "28.5~42.88 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8670.jpg",
"count": 6
},
{
"id": 4313,
"name": "奥迪A6L",
"kind": "中大型车",
"priceRange": "38.3~74.26 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4313.jpg",
"count": 59
},
{
"id": 4457,
"name": "奥迪Q5",
"kind": "中大型SUV",
"priceRange": "35.85~56.77 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_4457.jpg",
"count": 20
},
{
"id": 3524,
"name": "奥迪A4L",
"kind": "中型车",
"priceRange": "27.28~57.81 万",
"photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
"count": 32
}
]
}
]
}
}}}
== 3.开发时间、负责人、进度和实现方式==
||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||=接口进度(百分比)=||=接口实际[[BR]]完成时间=||=实现方式=||
||第一批|| 首页 ||2.1 [#point201 左侧主菜单 ] ||- || - || - || 完成 || - || madmin配置
||第一批|| 首页 ||2.2 [#point202 默认订阅栏目 ] ||- || - || - || 完成 || - || madmin配置
||第一批|| 首页 ||2.3 [#point203 头条 ] ||- || - || - || - || - || mrobot实现
||第一批|| 首页 ||2.31 [#point203 车系聚合页 ] ||- || - || - || 静态数据 || - || mrobot实现
||第一批|| 文章、帖子、图集 ||2.4 [#point204 赞和踩 ] ||- || - || - || - || - || 外部系统实现
||第一批|| 资讯栏目 ||2.5 [#point205 搜索栏目文章 ] ||- || - || - || 可内测 || - || mrobot实现
||第一批|| 个人中心 ||2.6 [#point206 新消息 ] ||- || 个人中心同事 ||-|| 完成 || - || mrobot代理
||第一批|| 左侧菜单 ||2.7 [#point207 您可能对以下内容感兴趣 ] ||- || - ||-|| 完成 || - || madmin配置
||第一批|| 我的收藏 ||2.8 [#point208 收藏夹信息---文章 ] ||-|| 个人中心同事 ||-|| 静态数据 || - || mrobot代理
||第一批|| 我的收藏 ||2.9 [#point209 收藏夹信息---帖子 ] ||- || 个人中心同事 ||-|| 静态数据 || - || mrobot代理
||第一批|| 我的收藏 ||2.10 [#point210 收藏夹信息---车型 ] ||- || 个人中心同事 ||-|| 静态数据 ||-|| mrobot代理
||第一批|| 我的收藏 ||2.11 [#point211 添加收藏 ] ||- || 个人中心同事 ||-|| - ||-|| mrobot代理
||第一批|| 我的收藏 ||2.12[#point212 删除收藏 ] || - || 个人中心同事 ||-|| - || - || mrobot代理
||第一批|| 我的订阅 ||2.13 [#point213 获取我的订阅 ] ||- || 个人中心同事 ||-|| 静态数据 ||-|| mrobot代理
||第一批|| 我的订阅 ||2.14 [#point214 添加我的订阅 ] ||- || 个人中心同事 ||-|| - || - || mrobot代理
||第一批|| 我的订阅 ||2.15 [#point215 删除我的订阅 ] ||- || 个人中心同事 ||-|| - || - || mrobot代理
||第一批|| 我的消息 ||2.16 [#point216 获取提醒内容 ] ||- || 个人中心同事 ||-|| 静态数据 || - || mrobot代理
||第一批|| 我的消息 ||2.17 [#point217 删除提醒 ]||- || 个人中心同事 ||-|| - || - || mrobot代理
||第一批|| 我的消息 ||2.18 [#point218 获取私信列表 ] ||- || 个人中心同事 ||-|| 静态数据 || - || mrobot代理
||第一批|| 我的消息 ||2.19 [#point219 获取个人私信 ] ||- || 个人中心同事 ||-|| 静态数据 || - || mrobot代理
||第一批|| 我的消息 ||2.20 [#point220 发送私信 ] ||-|| 个人中心同事 ||-|| - ||- || 外部系统实现
||第一批|| 我的消息 ||2.21 [#point221 删除私信 ] ||-|| 个人中心同事 ||-|| - ||- || mrobot代理
||第一批|| 我的帖子 ||2.22 [#point222 获取我的帖子 ] ||-|| 个人中心同事 ||-|| 未排序、未添加顶数和踩数 ||- || mrobot代理
||第一批|| 车型库首页品牌列表 ||2.23 [#point223 车型库首页品牌列表 ] ||-|| - ||-|| 可内测 ||- || mrobot代理
||第一批|| 精准选车条件 ||2.24 [#point224 精准选车条件 ] ||-|| - ||-|| 可内测 ||- || mrobot实现
||第一批|| 车主点评列表 ||2.25 [#point225 获取车主点评列表 ] ||-|| 车型库同事 ||-|| 静态数据 ||- || mrobot代理
||第一批|| 图片终端页 ||2.26 [#point226 车型图片列表 ] ||-|| 车型库同事 ||-|| 完成 ||- || mrobot代理
||第一批|| 论坛帖子列表 ||2.27 [#point227 论坛帖子列表 ] ||-|| 论坛同事 ||-|| 未排序、未添加顶数和踩数 ||- || mrobot代理
||第一批|| 询底价页 ||2.28 [#point228 询底价页 ] ||-|| 前端同事 ||-|| - ||- || mrobot实现
||第一批|| 经销商详情页 ||2.29 [#point229 经销商详情页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现
||第一批|| 车型终端页 ||2.30 [#point230 车型终端页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现
||第一批|| 车型对比页 ||2.31 [#point231 车型对比页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现
||第一批|| 车主点评终端页 ||2.32 [#point232 车主点评终端页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现
||第一批|| 预约驾车页 ||2.33 [#point233 预约驾车页 ] ||-|| 车型库、前端同事 ||-|| - ||- || mrobot实现
||第一批|| 车型降价信息 ||2.34 [#point234 车型降价信息 ] ||-|| 车型库同事 ||-|| 静态数据 ||- || mrobot代理
||第一批|| 车主点评终端页 ||2.35 [#point235 文章终端json ] ||-|| - ||-|| 可内测 ||- || mrobot实现
||第一批|| 车型库图集类别 ||2.36 [#point236 车型库图集类别 ] ||-|| - ||-|| 完成 ||- || mamdin实现
||第一批|| 车型库图集类别 ||2.37 [#point237 编辑订阅列表 ] ||-|| 个人中心同事 ||-|| - ||- || 外部系统实现
||第一批|| 车型库图集类别 ||2.38 [#point238 车型库首页热门车系列表 ] ||-|| - ||-|| 完成 ||- || madmin实现