[[TOC]]

== 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 [=#point201 左侧主菜单]===
{{{
    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 [=#point202 默认订阅栏目]===
{{{
    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 [=#point203 头条]===
{{{
    url:http://mrobot.pcauto.com.cn/v2/cms/channels/1?serialIds=3524,8670 (暂时不出静态数据)
    作用:获取头条数据，
    使用范围:汽车网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条
"data": [
{
"count": 93,     // 如果是文章则为评论数，如果是帖子则为楼层数，如果是图集则为图片张数
"id": 2965125,     // 文章、帖子或者图集id
"type":"",                // 类型，目前包含article, album和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    // 踩的数量
},
...
],
"focus":[
{
"img:":"http://img0.pcauto.com.cn/pcauto/1308/29/g_2965125_1377744114989_240x160.jpg",
"id":111111  // 同上
}
],
topArticles:[],
topFocus:[]
}}}

=== 2.3.1 [=#point2031 车系聚合页]===
{{{
    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                   
    请求参数:
          车系id
          pageNo：页数
          pageSize：每页显示多少条
    返回参数：
{
"pageNo":1,
"pageSize":20,
"total":300,   // 栏目内容总数，最多300条
"data": [
{
"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整理的栏目
"forum":"论坛版块",
"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                         
    是否需要登录：否                          
    请求参数：
          栏目id
          serialIds：车系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
          用户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
          用户id
          pageNo：页数
          pageSize：每页显示多少条
    返回参数：
{
    "pageNo": 1,
    "pageSize": 20,
    "total": 300,
    "topicList": [
        {
            "id": 82360,//收藏id
            "topicId": 3811550,//帖子id
            "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：用户登陆后获得的认证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：用户登陆后获得的认证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",
            "serialId": 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:用户登陆后获得的认证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:用户登陆后获得的认证id
             ids=1,2,3
    返回参数：
{
  "code": 1,     // 1代表成功，0代表失败
  "msg": ""      // 结果提示
}

}}}
=== 2.16 [=#point216 获取提醒]===
{{{
    url:http://mrobot.pcauto.com.cn/v3/bbs/getReminds?pageSize=20&pageNo=1
    作用:我的消息---提醒
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：是
    设计稿：http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html     
    请求参数：
          common_session_id：用户登陆后获得的认证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,
        "createAt": 1382582506000,
        "toReply": "引用内容",
        "content": "回复内容",
        "topicId":123,    // 如果这条回复是评论，则这是对应评论列表的主题id；如果是回复帖子，为0
        "topicUrl":"" ,     // 如果这条回复是评论，则这是对应评论列表的主题url；如果是回复帖子，为空字符串
        "articleTitle":"",  // 如果这条回复是评论，则这是对应文章的标题；如果是回复帖子，为空字符串
        "floorId":123 ,  // 该回复的楼层id，评论和帖子都用这个字段
        "floor":123        // 该回复的楼层数，评论和帖子都用这个字段
      }
    ]
}
ps：这接口内容有3种
1.我发的帖子，别人回帖
2.我发的回帖，别人回复
3.我发的文章评论，别人回复

}}}

=== 2.17 [=#point217 删除提醒] ===
{{{
    url:
    作用:删除提醒
    使用范围:汽车网app

    HTTP请求方式：post
    是否需要登录：是                          
    请求参数：

    返回参数：
{
  "code": 0,   // 0代表成功，-1代表失败
}

}}}

=== 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：用户登陆后获得的认证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",
        "senderNickName": "testpcatuo",//发送方
        "senderId": 24286812,//发送方
        "createAt": 1372392697000,
        "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:用户登陆后获得的认证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 发送私信]===
{{{
  url：http://bip.pcauto.com.cn/intf/message.jsp?act=create
  请求参数：
    accountId 发送给某个用户
    content 消息内容
    captcha 验证码

            /*
             * 发送限制 add by handy 2012.04.01
             * 1.post 2.验证码 3.黑名单
             * 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 edit by handy 2012.04.10
             * 5.发送频率 50次/ID/24H
             * 6.白名单最多一次发送50个用户，非白名单则每次只能发一个 7.添加关键词库过滤
             */

 结果返回
 {code:0,message:"提示"}

设计稿：http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html

具体请参考汽车论坛app对该接口的使用方法
}}}
=== 2.21 [=#point221 删除私信]===
{{{
    url:http://bip.pcauto.com.cn/intf/message.jsp
    作用:删除私信
    使用范围:汽车网app

    HTTP请求方式：post
    是否需要登录：是                          
    请求参数：
          common_session_id：用户登陆后获得的认证id
          act：用于区分动作，此处使用delete，即act=delete
          messageId：消息id，使用【2.18 获取私信列表】接口中的messageId字段，如果一次性要删除多条消息，请拼接多个messageId参数，即：messageId=xxx&messageId=xxx
    设计稿：http://192.168.50.213/2013.09/pcauto_4.0/auto_message.html
    返回参数：
{
  "code": 0,  // 0代表成功，-1代表失败
  "message":"缺少参数" //失败时的提示文本
}

}}}
=== 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
   请求参数：车系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
   请求参数：车系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&pageNo=1
   作用：获取文章内容
   使用范围：汽车网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:用户登陆后获得的认证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.3.1 [#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 删除私信 ] ||-|| 个人中心同事  ||-|| 完成 ||- || 外部系统实现
||第一批|| 我的帖子 ||2.22 [#point222 获取我的帖子 ] ||-|| 个人中心同事  ||-|| 未排序、未添加顶数和踩数、缺少image ||- || 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实现