pcauto_4.0.0/interface – iphone

wiki:pcauto_4.0.0/interface

Context Navigation

Version 166 (modified by fuxingfang, 12 years ago) (diff)
--

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: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 车系聚合页

    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 赞和踩

    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 搜索栏目文章

    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 新消息

    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 您可能对以下内容感兴趣

    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 收藏夹信息---文章

    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 收藏夹信息---帖子

    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 收藏夹信息---车型

     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 添加收藏

设计稿：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 删除收藏

   1.删除收藏的帖子：
     url：http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp
     请求参数：
             common_session_id：用户登陆后获得的认证id
             id：收藏id，使用【2.9 收藏夹信息---帖子】接口中的id字段，如果一次性要删除收藏的多条帖子，请拼接多个id参数，即：id=xxx&id=xxx
   2.删除收藏的车型：
   3.删除收藏的文章：
 
设计稿：http://192.168.50.213/2013.09/pcauto_4.0/auto_collect.html

2.13 获取我的订阅

    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 增加订阅

  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 删除订阅

  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 获取提醒内容

    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 删除提醒

    url:http://bip.pcauto.com.cn/intf/sysnotice.jsp
    作用:删除提醒
    使用范围:汽车网app

    HTTP请求方式：post
    是否需要登录：是                          
    请求参数：
          common_session_id：用户登陆后获得的认证id
          act：用于区分动作，此处使用delete，即act=delete
          noticeId：消息id，使用【2.16 获取提醒内容】接口中的noticeId字段，如果一次性要删除多条消息，请拼接多个noticeId参数，即：noticeId=xxx&noticeId=xxx
    返回参数：
{
  "code": 0,  // 0代表成功，-1代表失败
  "message":"" //失败时会有此字段，提示文本
}

2.18 获取私信列表

    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 获取个人私信

    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 发送私信

  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 删除私信

    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 我的帖子

   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 车型库首页品牌列表

   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 精准选车条件

   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 车主点评列表

   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 车型图片列表

   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 论坛帖子列表

   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 询底价页

需求：重新设计询底价页[[BR]]
设计稿：http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]]
url：待定[[BR]]

2.29 经销商详情页

需求：重新设计经销商详情页[[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 车型终端页

需求：重新设计车型终端页；需要把同车系的所有车型都放到html里，类似文章终端的html_meta数据。[[BR]]
设计稿：http://192.168.50.175/work/201309/pcauto4.0/chexing/chexing.html[[BR]]
url：待定[[BR]]

2.31 车型对比页

需求：更改为整个车型对比页都由HTML实现[[BR]]
设计稿：http://192.168.50.175/work/201309/pcauto4.0/chexing/duibijieguo.html[[BR]]
url：待定[[BR]]

2.32 车主点评终端页

需求：新增页面；需要把同车系的所有车型都放到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 预约驾车页

需求：新增页面[[BR]]
设计稿：http://192.168.50.175/work/201309/pcauto4.0/chexing/xunjia.html[[BR]]
备注：咨询小虎，看提交到什么地方
url：待定[[BR]]

2.34 车型降价信息

   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 文章终端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 车型库图集类别

   url:madmin配置项：pcauto_albums_types
   作用：获取车型库图集列表的类别
   使用范围：汽车网app
   是否需要登录：否
   备注：madmin出
   数据格式：
{
    "types": [
        {
            "name": "外观",
            "id": "1"
        },
        {
            "name": "内饰",
            "id": "2"
        },
        {
            "name": "空间",
            "id": "8"
        },
        {
            "name": "其他",
            "id": "3"
        }
    ]
}

2.37 编辑订阅列表

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 车型库首页热门车系列表

    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接口	是否需要 HTML切图	需配合的接口负责人及进度	接口开发预计时间	接口进度（百分比）	接口实际完成时间	实现方式
第一批	首页	2.1 左侧主菜单	-	-	-	完成	-	madmin配置
第一批	首页	2.2 默认订阅栏目	-	-	-	完成	-	madmin配置
第一批	首页	2.3 头条	-	-	-	-	-	mrobot实现
第一批	车系聚合页	2.3.1 车系聚合页	-	-	-	静态数据	-	mrobot实现
第一批	文章、帖子、图集	2.4 赞和踩	-	-	-	-	-	外部系统实现
第一批	资讯栏目	2.5 搜索栏目文章	-	-	-	可内测	-	mrobot实现
第一批	个人中心	2.6 新消息	-	个人中心同事	-	完成	-	mrobot代理
第一批	左侧菜单	2.7 您可能对以下内容感兴趣	-	-	-	完成	-	madmin配置
第一批	我的收藏	2.8 收藏夹信息---文章	-	个人中心同事	-	静态数据	-	mrobot代理
第一批	我的收藏	2.9 收藏夹信息---帖子	-	个人中心同事	-	可内测	-	mrobot代理
第一批	我的收藏	2.10 收藏夹信息---车型	-	个人中心同事	-	静态数据	-	mrobot代理
第一批	我的收藏	2.11 添加收藏	-	个人中心同事	-	-	-	mrobot代理
第一批	我的收藏	2.12删除收藏	-	个人中心同事	-	-	-	mrobot代理
第一批	我的订阅	2.13 获取我的订阅	-	个人中心同事	-	静态数据	-	mrobot代理
第一批	我的订阅	2.14 添加我的订阅	-	个人中心同事	-	-	-	mrobot代理
第一批	我的订阅	2.15 删除我的订阅	-	个人中心同事	-	-	-	mrobot代理
第一批	我的消息	2.16 获取提醒内容	-	个人中心同事	-	可内测	-	mrobot代理
第一批	我的消息	2.17 删除提醒	-	个人中心同事	-	完成	-	外部系统实现
第一批	我的消息	2.18 获取私信列表	-	个人中心同事	-	可内测	-	mrobot代理
第一批	我的消息	2.19 获取个人私信	-	个人中心同事	-	静态数据	-	mrobot代理
第一批	我的消息	2.20 发送私信	-	个人中心同事	-	完成	-	外部系统实现
第一批	我的消息	2.21 删除私信	-	个人中心同事	-	完成	-	外部系统实现
第一批	我的帖子	2.22 获取我的帖子	-	个人中心同事	-	未排序、未添加顶数和踩数、缺少image	-	mrobot代理
第一批	车型库首页品牌列表	2.23 车型库首页品牌列表	-	-	-	可内测	-	mrobot代理
第一批	精准选车条件	2.24 精准选车条件	-	-	-	可内测	-	mrobot实现
第一批	车主点评列表	2.25 获取车主点评列表	-	车型库同事	-	静态数据	-	mrobot代理
第一批	图片终端页	2.26 车型图片列表	-	车型库同事	-	完成	-	mrobot代理
第一批	论坛帖子列表	2.27 论坛帖子列表	-	论坛同事	-	未排序、未添加顶数和踩数	-	mrobot代理
第一批	询底价页	2.28 询底价页	-	前端同事	-	-	-	mrobot实现
第一批	经销商详情页	2.29 经销商详情页	-	车型库、前端同事	-	-	-	mrobot实现
第一批	车型终端页	2.30 车型终端页	-	车型库、前端同事	-	-	-	mrobot实现
第一批	车型对比页	2.31 车型对比页	-	车型库、前端同事	-	-	-	mrobot实现
第一批	车主点评终端页	2.32 车主点评终端页	-	车型库、前端同事	-	-	-	mrobot实现
第一批	预约驾车页	2.33 预约驾车页	-	车型库、前端同事	-	-	-	mrobot实现
第一批	车型降价信息	2.34 车型降价信息	-	车型库同事	-	静态数据	-	mrobot代理
第一批	车主点评终端页	2.35 文章终端json	-	-	-	可内测	-	mrobot实现
第一批	车型库图集类别	2.36 车型库图集类别	-	-	-	完成	-	mamdin实现
第一批	车型库图集类别	2.37 编辑订阅列表	-	个人中心同事	-	-	-	外部系统实现
第一批	车型库图集类别	2.38 车型库首页热门车系列表	-	-	-	完成	-	madmin实现

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 左侧主菜单

2.2 默认订阅栏目

2.3 头条

2.3.1 车系聚合页

2.4 赞和踩

2.5 搜索栏目文章

2.6 新消息

2.7 您可能对以下内容感兴趣

2.8 收藏夹信息---文章

2.9 收藏夹信息---帖子

2.10 收藏夹信息---车型

2.11 添加收藏

2.12 删除收藏

2.13 获取我的订阅

2.14 增加订阅

2.15 删除订阅

2.16 获取提醒内容

2.17 删除提醒

2.18 获取私信列表

2.19 获取个人私信

2.20 发送私信

2.21 删除私信

2.22 我的帖子

2.23 车型库首页品牌列表

2.24 精准选车条件

2.25 车主点评列表

2.26 车型图片列表

2.27 论坛帖子列表

2.28 询底价页

2.29 经销商详情页

2.30 车型终端页

2.31 车型对比页

2.32 车主点评终端页

2.33 预约驾车页

2.34 车型降价信息

2.35 文章终端json

2.36 车型库图集类别

2.37 编辑订阅列表

2.38 车型库首页热门车系列表

3.开发时间、负责人、进度和实现方式

Download in other formats: