[[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是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号。

}}}

== 2.接口列表 ==
'''温馨提示：因电脑网论坛7.0 7月9日才上线，故电脑网论坛和个人中心的接口需使用测试环境接口，所以客户端同事测试时请登陆测试环境。 [[BR]]
电脑网论坛测试环境首页如为：http://v26.pconline.com.cn/index.do  用户名：baidu，密码：123456 [[BR]]
请使用common_session_id1，而非common_session_id'''

=== 2.1 [=#point201 新消息]===
{{{
    url:
       汽车网：待定
       电脑网：待定
    作用:获取个人中心的新消息的数量(系统消息和短消息)
    使用范围：电脑网app、汽车网app

    HTTP请求方式：get                         
    是否需要登录：是                          
    请求参数：
             common_session_id:用户登陆后获得的认证id
    返回参数：
    {

    "systemNoticeCount": 0, //系统消息数
    "messageCount": 0, // 短消息数
    "fansCount": 0 //新粉丝数
}

}}}

=== 2.2 [=#point202 栏目页topArticle增加楼层数和图集张数]===
{{{
    url:
       汽车网：http://mrobot.pcauto.com.cn/v2/cms/channels/1 (已上线)
       电脑网：http://mrobot.pconline.com.cn/v2/cms/channels/1 (已上线)
    使用范围：电脑网app、汽车网app
    HTTP请求方式：get
    是否需要登录：否
    请求参数:栏目ID
    备注：添加total字段；并且给所有栏目实现分页功能
    例子：
    {
    "topArticle":[

        {
            "pubDate":"2013-03-20",
            "title":"专利败诉 HTC再度悲剧……",
            "updateAt":1363708800000,
            "to-uri":"pconlinebrowser://bbs-topic/16348932",
            "preView":"专利败诉 HTC再度悲剧……",
            "seq":15,
            "image":"http://img0.pconline.com.cn/pconline/1303/20/3220919_f3.jpg",
            "floorCount":15    // 楼层数
        },
        {
            "pubDate":"2013-03-11",
            "title":"摄影部落美图——《日出赛罕坝》",
            "updateAt":1362931200000,
            "to-uri":"pconlinebrowser://album-photo/9792",
            "preView":"摄影部落美图——《日出赛罕坝》",
            "seq":20,
            "image":"http://img0.pconline.com.cn/pconline/1303/11/3209641_f2.jpg",
            "numCount":20    //  图集的图片张数
        }
    ],
    "total":100,   //articleList和topArticles的总和
    "articleList":[
        
    ],
    "topFocus":[
    ]
}
    备注：除topArticle外的数据，其他都不变，topArticle里面的论坛和图集分别增加一个楼层数和图集张数的字段
}}}

=== 2.3 [=#point203 我的帖子]===
{{{
url：
  汽车网：http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20  (已上线)
  电脑网：http://mrobot.pconline.com.cn/v3/itbbs/myTopics/826717?pageNo=2 (可内测)
作用:获取某用户发布的所有帖子
使用范围：电脑网app、汽车网app

请求方式：get
是否需要登录：是
请求参数：
pageNo:页数
common_session_id:用户登陆后获得的认证id
pageSize:每页条数 

例子：
｛
    "pageNo":1, //页码
    "pageSize":20, //每页条数
    "topicList":[  /
        {
            "updateAt":123,   //格式是时间戳，创建或最终修改时间
            "flag":"精", //是否为精，图等
            "replyCount":6175,//回复数
            "view":195872,//阅读数
             "floor":812,//楼层数
            "title":"三两下root好并精简你的三星I9100",//标题
            "topicId":13597147, // 帖子id
            "uri":"http://itbbs.pconline.com.cn/mobile/13597147.html" //帖子url  
	 }
    ],
    "total":12  //一共多少条
}
}}}

=== 2.4 [=#point204 帖子回复]===
{{{
url：汽车网：http://mrobot.pcauto.com.cn/v3/bbs/postReplys (可内测)
     电脑网：http://mrobot.pconline.com.cn/v3/itbbs/postReplys (可内测)
作用：获取别人对自己发表的所有帖子的回复
使用范围：电脑网app、汽车网app

请求方式：get 
是否需要登录：是
请求参数：
pageNo:页数 
common_session_id:用户登陆后获得的认证id 
pageSize:每页条数 


例子：
｛
      "pageNo":1, //页码
      "pageSize":20, //每页条数
     "topicList":[ /
          {
               "updateAt":123, //格式是时间戳，创建或最终修改时间
               "replyName":“你好” //回复者名称，
               "replyImage":“http://mrobot….jpg” //回复者头像url
               "title":"三两下root好并精简你的三星I9100",//标题
               "replyContent":"回复内容为9", //回复内容,字数限制
               "topicId":13597147, // 帖子id
              "replyCount":6175,//回复数
            "view":195872,//阅读数
             "floor":812,//楼层数
               "uri":"http://itbbs.pconline.com.cn/mobile/13597147.html" //帖子url      
              
          }
     ],
     "total":12 //一共多少条
}
}}}

=== 2.5 [=#point205 评论回复]===
{{{
url：待定
作用:获取别人对自己发表的所有评论的回复
使用范围：电脑网app、汽车网app

请求方式：get 
是否需要登录：是
请求参数： 
pageNo:页数 
common_session_id:用户登陆后获得的认证id 
pageSize:每页条数 

例子：
｛
      "pageNo":1, //页码
      "pageSize":20, //每页条数
     "topicList":[ 
          {
               "updateAt":123, //格式是时间戳，创建或最终修改时间
               "commentId":"评论id", //  对应的评论id
               "topicId":"文章评论对应的主题id", //
               "replyContent":"回复内容为9", //回复内容
               "articleId":13597147 // 原文id
          }
     ],
     "total":12 //一共多少条
}
}}}

=== 2.6 [=#point206 同步内容下载]===
{{{
url：
   汽车网：http://mrobot.pcauto.com.cn/v3/bbs/collectionDownload/13128876?pageSize=20&pageNo=1 (已上线)
   电脑网：http://mrobot.pconline.com.cn/v3/itbbs/collectionDownload/13128876?pageNo=1 (已上线)
作用：同步论坛收藏的内容
使用范围：电脑网app、汽车网app


请求方式：get
是否需要登录：是
请求参数：
 common_session_id:用户登陆后获得的认证id 
 pageSize:每页的数据量，只对论坛和帖子起作用；假如pageSize=20，那么论坛和帖子分别返回20条数据
 pageNo:页码

注：车型，车系为汽车网客户端独有，其他2个是三个都有
例子：
｛
           "pageCount":100,  //如果论坛版块的总页数大于帖子的总页数就使用论坛的总页数，否则使用帖子的总页数
           "pageNo":2, //页码
           "total":38,    //帖子和论坛版块的总数
	“seriesList”:[//车系

            	 {
			“id”:1234,  //爱车id
                        “seriesId”：145，//车系id
  	 	 	“name”:”宝马3系”, //车系名字
			“image”:http://mrobot.pcauto.com/baoma3.jpg //车系小图url
             	},
             	{
			“id”:1234,  //爱车id
                        “seriesId”：145，//车系id
  	 	 	“name”:”宝马”, //车系名字
			 “image”:http://mrobot.pcauto.com/baoma.jpg //车系小图url
            	 }
            ],

       “modelList”:[//车型
            	 {
			“id”:1234,  //爱车id
                        “modelId”：145，//车型id
  	 	 	“name”:”宝马”, //车型名字
			 “image”:http://mrobot.pcauto.com/baoma.jpg   //车型小图url
             	},
             	{
			“id”:1234,  //爱车id
                        “modelId”：145，//车型id
  	 	 	“name”:”宝马”, //车型名字
			 “image”:http://mrobot.pcauto.com/baoma.jpg //车型小图url
             	}
             ],

	  	 “forumList”:[//论坛
            	 {
			“id”:1234,  //收藏id
                        “forumId”：145，//论坛版块id
  	 	 	“name”:”宝马”, //论坛名字
           	  },
            	 {
	 	 	“id”:1234,  //收藏id
                        “forumId”：145，//论坛版块id
  	 	 	“name”:”宝马”, //论坛名字
            	 }
            ],


		 “topicList”:[//帖子
            	 {
			“id”:1234,  //收藏id
                        “topicId”：145，//帖子id
  	            	“name”:”宝马3系太好了”, //帖子标贴
		},
             	{
			“id”:1234,  //收藏id
                        “topicId”：145，//帖子id
  	                “name”:”宝马3系太好了”, //帖子标贴
            	 }
            ]
}

}}}

=== 2.7 [=#point207 同步内容上传]===
{{{
   汽车网：http://mrobot.pcauto.com.cn/v3/bbs/collectionUpload (已上线)
   电脑网：http://mrobot.pconline.com.cn/v3/itbbs/collectionUpload (已上线)
作用：同步论坛收藏的内容
使用范围：电脑网app、汽车网app

请求方式：post
是否需要登录：是
请求参数：
 common_session_id:用户登陆后获得的认证id 
 json：需要上传的数据提交给该参数。
注：车型，车系为汽车网客户端独有，其他2个是三个都有

例子：
           ｛
          “series”:{  //车系
	          “addList”:[123121,1111,2222,3333,566788], //新增车系id数组，此处的id即为同步下载接口中的seriesId，没有新增的车系该字段留空，即“addList”:[]，如下同。
		  “deleteList”:[12356,6666,5555,32145] //删除车系数组，此处的id为爱车id，即为同步下载接口中seriesList下的id字段
                    },
          "model":｛  //车型
		“addList”:[{serialId:111, modelId:111},{serialId:111, modelId:111}], //新增车型id数组，serialId为车系id，modelId为车型id
		“deleteList”:[12356,6666,5555,32145]   //删除车型数组，此id为爱车id，即为同步下载接口中modelList的id字段
                    ｝,
          “forum”:{ //论坛
		“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组，此处的id即为同步下载接口中的forumId
		“deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中forumList下的id字段
                    },
          “topic”:{ //帖子
		“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组，此处的id即为同步下载接口中的topicId
		“deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中topicList下的id字段

          }
}

}}}

=== 2.8 [=#point208 汽车论坛的首页热门] ===
{{{
    url: http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20 (已上线)
    作用:获取论坛的热门帖子列表
    使用范围：汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数: pageSize：每页显示的记录数
              pageNo: 当前页数

    返回参数：
{
    "total":200,                                      //总数
    "pageNo":1,                                       //页码
    "pageSize":20,                                   //每页有多少调
    "focus":[
        {
            "title":"abc",
            "image":"http://xxxx.png",           //焦点图
            "topicId":"123456"                            //帖子id
        }
    ],
    "topicList":[
        {
            "title":"todo",                              //帖子标题
            "createAt":123, //格式是时间戳，创建或最终修改时间
            "replyCount":100,                      //帖子的回复数
            "replyView":100,                       //帖子的阅读数
            "author":"todo",                          //帖子的作者
            "topicId":"123456",                            //帖子id
            "image":"http://xxxx.png",             //帖子的导读图
        }
    ]
}


}}}


=== 2.9 [=#point209 论坛的帖子列表重构] ===
{{{
    url: 汽车网：http://mrobot.pcauto.com.cn/v3/bbs/newForums/14140?filter=pick&pageNo=1&pageSize=1 (已上线)
         电脑网：http://mrobot.pconline.com.cn/v3/itbbs/newForums/768176?filter=top&pageNo=1&pageSize=20# (已上线)

    分别对应的原接口地址为：
        汽车网：http://bbs.pcauto.com.cn/rest/forums/14140?filter=pick&pageNo=1&pageSize=20
        电脑网：http://itbbs.pconline.com.cn/rest/forums/768714?filter=pick&pageNo=1&pageSize=20

    作用:获取某论坛帖子列表
    使用范围：汽车网app、电脑网app、汽车论坛app
    备注：新建madmin操作后台，后台支持添加某些帖子到列表的topTopics字段；不同的板块有不同的topTopics，不提供板块选择，操作者自行填写板块id。

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：在原来的参数基础上添加以下请求参数：
               filter:  pick，精选贴；top，置顶帖。其中置顶帖没有分页。
               orderby： postat，发帖时间排序；replyat，回帖时间排序（默认回帖排序)；
    返回参数：
{
......
    "topTopics":[
        {
            "pubDate":"2013-03-28",                 //发布日期
            "updateAt":123, //格式是时间戳，创建或最终修改时间
            "title":"每日签到：锤子发布了，罗永浩的魔术到底改变了什么？",        //帖子标题
            "topicId":16378805,                          // 帖子id
            "seq":4,             //表示该帖子会出现在列表中的位置
            "image":"http://img0.pconline.com.cn/pconline/1303/28/3233368_f23.jpg",   //导读图
            "replyCount":1111,       //帖子回复数
            "view":111           // 帖子阅读数
            "author":"todo"    //帖子作者
        }
    ]
}

}}}

=== 2.10 [=#point210 新版帖子页] ===
{{{
    url: 汽车网：http://mrobot.pcauto.com.cn/v2/bbs/topics/3647953?pageNo=1&pageSize=20 (已上线)
         电脑网：http://mrobot.pconline.com.cn/v2/itbbs/topics/49817167?topicTemplate=3.6.0&picRule=0 (已上线)
    作用:套用新模板帖子终端页 
    使用范围：汽车网app、电脑网app、汽车论坛app
    备注：新模板要求显示该帖子所属的论坛入口，链接为{$app}://bbs-topics/{$id}；
          显示楼主的论坛等级；
          显示回复数和阅读数；
          添加回复按钮，链接为pcaction://reply?tid={$tid}&pid={$pid}&floor={$floor}，参数分别为帖子id、楼层id和楼层索引;
          当该帖子为精华帖时，需要显示相应的提示。
          修改源代码内的这段代码：/*@_HTML_META_START_
{"title":"紧急联络号   1号在手   拓友走遍全国（随时更新）","pageNo":1,"pageCount":5,"webUrl":"http://bbs.pcauto.com.cn/topic-3630588.html","userId":5609632,"favoriteId":-1}
_HTML_META_END_@*/，添加favoriteId字段。该字段在不传入common_session_id始终返回-1；在传入common_session_id的情况，如果该用户有收藏该帖子则返回对应的favoriteId，没有收藏的话则返回-1。
         当帖子终端显示为大图时，点击图片触发pcaction://big-photo?url="xxx.jpg"
         查看设计稿：http://192.168.50.207/2013.04/App4.0/pcauto/auto_lttz.html
         调整字体：参考2.20文章页
         夜间模式：参考2.20文章页

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数，在原有的参数基础上添加以下参数：
        topicTemplate: 当该值为3.6.0时，才请求新模板的终端；否则请求的是旧帖子终端。
        picRule：只有0，1和2三个值。为0第一张图显示大图，其他显示文字链，点击打开大图；为1所有图片显示文字链，点击打开大图，设两个值是为了和文章的处理保持一致；为2时直接显示大图。
        authorId: 为楼主id时只显示楼主发布的楼层；authorId可以在/*@_HTML_META_START_  _HTML_META_END_@*/里找到
        app: 参考2.20文章页
       

}}}

=== 2.11 [=#point211 回复楼层] ===
{{{
    url: 汽车网：http://mrobot.pcauto.com.cn/proxy/bbs/topics/3748783 (已上线)
         电脑网：http://mrobot.pconline.com.cn/proxy/itbbs/topics/50477755 (已上线)
    作用:回复帖子里的某个楼层
    使用范围：汽车网app、电脑网app、汽车论坛app
    
    是否需要登录：是
    请求方法：post
    请求参数：
        common_session_id：用户登陆后获得的认证id ；
        replyToId：楼层id；
        message：回复内容；
}}}


=== 2.12 [=#point212 推荐论坛] ===
{{{
    url:待定
    作用:获取电脑网论坛推荐的版块
    使用范围:电脑网app
    
    请求参数: 无
    请求方法：get
    是否需要登录：否
    返回参数：
{
    "total":123,    //推荐的论坛总数
    "forums":[
        {
            "image":"http://xxx.png",    //显示的图片
            "name":"todo",                  //板块的名字
            "forumId":123456             //板块id
        }
    ]
}
}}}

=== 2.13 [=#point213 推荐帖子] ===
{{{
    url:http://mrobot.pconline.com.cn/v3/itbbs/recommendTopics?pageSize=20&pageNo=1 (可内测)
    作用:获取电脑网论坛推荐的帖子
    使用范围：电脑网app
    
    请求方法：get
    是否需要登录：否
    请求参数: pageSize：每页显示的记录数
              pageNo: 当前页数

    返回参数：
{
    "total":200,                                      //总数
    "pageNo":1,                                       //页码
    "pageSize":20,                                   //每页有多少调
    "topicList":[
        {
            "title":"todo",                              //帖子标题
            "replyCount":100,                      //帖子的回复数
            "replyView":100,                       //帖子的阅读数
            "createAt":123, //格式是时间戳，创建或最终修改时间
            "author":"todo",                          //帖子的作者
            "topicId":"123456",                            //帖子id
            "image":"http://xxxx.png",             //帖子的导读图
        }
    ]
}

}}}


=== 2.14 [=#point214 图集列表] ===
{{{
    url:
        汽车网：http://mrobot.pcauto.com.cn/v2/photo/albums?groupId=85 （未处理）
        电脑网：http://mrobot.pconline.com.cn/v2/photo/albums?groupId=25 （未处理）
    作用:获取图集列表，新做一个栏目，该栏目的封面是横图
    使用范围：电脑网app、汽车网app
    
    
    请求参数: 无
    请求方法：get
    是否需要登录：否
    返回参数：
{
    "count":115,
    "groups":[
        {
            "id":8840,
            "cover":"http://img.pconline.com.cn/images/piclib/201302/26/simple/1/1361842912743nylidq669z.jpg",
            "name":" 娇气萝莉教主琳达的R座驾",
            "photoCount":15,
            "url":"http://mrobot.pcauto.com.cn/v2/photo/albums?modelId=8840"
        }
    ]
}

}}}

=== 2.15 [=#point215 根据价格区间选车] ===
{{{
    url：http://mrobot.pcauto.com.cn/v3/price/getSerialListByPrice?minPrice=5&maxPrice=8 （已处理）
              
    作用:
    使用范围：汽车网app
    说明：原接口中增加车类型和价格范围字段。    

    请求参数: 无
    请求方法：get
    是否需要登录：否
    返回参数：
{
    "data":[
        {
            "manufacturerName":"宝骏",
            "letter":"B",
            "photo":"http://img3.pcauto.com.cn/pcauto/1011/29/1328218_baojun.png",
            "serials":[
                {
                    "id":"7032",
                    "name":"宝骏630",
                    "kind":"中小型车",                         //车的类型
                    "priceRange":"25.9~49.9 万",       //价格范围
                    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1303/28/c1/19301933_1364434425218_120x90.jpg"
                }
            ]
        }
    ]
}


}}}

=== 2.16 [=#point216 车型列表] ===
{{{
    url：http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524 (已上线)
    作用:
    使用范围：汽车网app
    备注：http://price.pcauto.com.cn/sg3225/， 获取这个地址里的车型列表；车型列表包含在售/停产在售、即将上市、停产和未上市三种，列表只出在售/停产在售和即将上市两种；title字段里面的车系名称去掉。
    
    请求参数: 无
    请求方法：get
    是否需要登录：否
    返回参数：
{
    "structure":"三厢车",
    "bbsId":"14359",
    "modelTotal":"8",
    "sections":[
        {
            "title":"1.4T 涡轮增压131马力",
            "status":"在售",
            "data":[
                {
                    "id":"21803",
                    "title":"2013款 1.8 30TFSI 手动舒适型",
                    "price":"272800",
                    "vendorPrice":"172899",
                    "status":"在售",
                    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/07/c9/12753707_12753707_1344329185828_120x90.jpg"
                },
                {
                    "id":"21804",
                    "title":"2013款 1.8 30TFSI 自动舒适型",
                    "price":"291000",
                    "vendorPrice":"172899",
                    "status":"即将上市",
                    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/07/c9/12753707_12753707_1344329185828_120x90.jpg"
                }
            ]
        }
    ],
    "gearbox":"手动 无级变速 双离合",
    "brandId":"1",
    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/01/c0/14229062_14229062_1349107127921_120x90.jpg",
    "kind":"中型车",
    "priceRange":"27.28~57.81万",
    "advantage":"外形颇具动感,底盘噪音抑制到位，全系标配电子手刹",
    "displacement":"1.8T 2.0T 3.0T",
    "photoTotal":"646",
    "brand":"奥迪",
    "serialGroupName":"奥迪A4L",
    "disadvatage":"底盘调教偏硬，滤震一般"
}


}}}


=== 2.17 [=#point217 车系相关文章列表] ===
{{{
    url:  http://mrobot.pcauto.com.cn/v3/price/getArticleInfoListBySerialId/7209?pageNo=1&pageSize=20 (完成)
          http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/7209?pageNo=1&pageSize=20&areaId=1 (完成)


          “最新资讯”：http://mrobot.pcauto.com.cn/v3/price/getNewestInfoListBySerialId/7209 (已上线)(无需分页)
          “新闻”：http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/7209?pageNo=1&pageSize=20 (已上线)
          “评测”：http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/7209?pageNo=1&pageSize=20 (已上线)
          “导购”：http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/7209?pageNo=1&pageSize=20 (已上线)
          
    作用:
    使用范围：汽车网app
    备注：新增4个接口，获取“最新资讯”、“新闻”、“评测”、“导购”栏目下的相关文章，格式和原来的接口一样。原来的两个接口在data下新增一个pubDate字段和updateAt时间戳字段，为文章的发布时间。
    
    
    请求参数: 无
    请求方法：get
    是否需要登录：否
    返回参数：
{
    "pageCount":"9",
    "pageNo":"1",
    "data":[
        {
            "commentNum":"0",
            "id":"2395585",
            "title":"“BMW大师殿堂”杨丽萍舞剧《孔雀》在陕西惊艳登场",
            "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png",
            "channel":"汽车报价",
            "pubDate":"2013-02-03",        //时间
            "mustWatch":"1"    //标记是否必看，1为是，0为否，最新资讯下的属性
        }
    ],
    "pageSize":"20"
}
}}}


=== 2.18[=#point218 车型概述页修改] ===
{{{
    url: 
         http://mrobot.pcauto.com.cn/v3/price/detailv36/24052 (最新版车型详细参数页，已上线)
         http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=4313&areaId=1 (最新版经销商列表页，已上线)
         http://mrobot.pcauto.com.cn/v3/price/dealersDetailv36?areaId=1&serialId=4313&seq=506800004 (最新版经销商详情页，已上线)
         http://mrobot.pcauto.com.cn/v3/price/modelsv36/20202?areaId=1&app=pcautobrowser (最新车型详情页，已上线)
    作用:
    使用范围：汽车网app
    备注：添加一个内部链接，链接写{$app}://model-detail/23097，查看设计稿：http://192.168.50.213/2013.04/App4.0/pcauto/auto_cxing.html
    
    
    请求参数：
        app:参考2.20文章页
        template:当该值为3.6.0时，应用新样式，否则不变
    请求方法：get
    是否需要登录：否
    返回参数：


}}}

=== 2.19[=#point219 专栏页] ===
{{{
    url: 待定
    作用:
    使用范围：汽车网app、电脑网app
    备注：顶部也是html实现，该位置存在一个内部链接，url待定，查看设计稿：http://192.168.50.213/2013.04/App4.0/pcauto/auto_zl.html
    
    请求参数：none
    请求方法：get
    是否需要登录：否
    返回参数：


}}}

=== 2.20[=#point220 文章页] ===
{{{
    url: 
        汽车网：http://mrobot.pcauto.com.cn/v3/cms/articles/2296581 (已上线)
        电脑网：http://mrobot.pconline.com.cn/v3/cms/articles/3043630 (已上线)
    作用:
    使用范围：汽车网app、电脑网app
    备注：本次实现针对articleTemplate=3.6.0的情况。
可通过js函数直接设置文章的字体大小：setFontSize(size)；小号是16，中号18，大号是20；
支持离线文章，兼容旧的离线文章；
可通过js函数控制日间和夜间模式，分别是modeDay()和modeNight()；另外可通过锚点请求不同模式，添加#night是夜间模式，不加是日间模式；
去掉全屏功能；
大图支持点击，点击返回该文章的所有未经压缩的图片url数组如下：
放出品牌和厂商的超链接，品牌为：${app}://nbrand/${id}，厂商为${app}://brand/${id}
pcaction://big-photo?data={
"total":10, "currentIndex":10, "photos":["xxx.jpg", "xxx.jpg", "xxx.jpg" ...]
}    
查看设计稿：http://192.168.50.207/2013.04/App4.0/pcauto/auto_wz.html
    请求参数：
        app: 表示请求该链接的应用。比如使用汽车网客户端请求，会传入pcautobrowser；使用车展速递会传入pcautoshow。
该值用以定制网页的内部链接，根据传入的值不同，内部链接会生成不用的协议，比如前文说的论坛入口，如果是传入pcautobrowser，
则论坛入口为pcautobrowser://bbs-topics/{$id}。车展和汽车论坛客户端以此类推。
        
    请求方法：get
    是否需要登录：否
    返回参数：


}}}

=== 2.21[=#point221 楼层内容页] ===
{{{
    url: 汽车网：http://mrobot.pcauto.com.cn/v3/bbs/floorContent/3516154?postId=33036415&picRule=1 (已上线)
         电脑网：http://mrobot.pconline.com.cn/v3/itbbs/floorContent/49817167?postId=479678831&picRule=1 (可内测)
    作用:
    使用范围：汽车网app、电脑网app
    备注：
    
    请求参数：
        postId:楼层id
        picRule:图片显示规则，具体规则请看帖子页。
    请求方法：get
    是否需要登录：否
    返回参数：
            包含楼层内容的网页，详情查看设计稿http://192.168.50.207/2013.04/App4.0/pcauto/auto_my.html

}}}

=== 2.22[=#point222 厂商车系列表] ===
{{{
    url: http://mrobot.pcauto.com.cn/v3/price/getSerialListByManufacturerId/37 (已上线)
    作用: 根据厂商id返回该厂商所属品牌的车系列表
    使用范围：汽车网app
    
    请求参数：厂商id
    请求方法：get
    是否需要登录：否
}}}

=== 2.23[=#point223 获取评论内容] ===
{{{
    url: 
    作用:
    使用范围：汽车网app、电脑网app
    备注：
    
    请求参数：
        topicId:主题id
        commentId:评论id
    请求方法：get
    是否需要登录：否
    返回参数:
{
    "myComment":"啊啊啊啊啊啊",   //我的评论
    "comment":"啊啊啊啊啊啊啊",  //别人回复我的评论
    "username":"username"  //回复者昵称
}

}}}

=== 2.24 [=#point224 修改用户昵称]===
{{{
url：
   汽车网：待定
   电脑网：待定
作用：同步论坛收藏的内容
使用范围：电脑网app、汽车网app
请求方式：post
是否需要登录：是
请求参数：
 common_session_id:用户登陆后获得的认证id 
 username:修改后的用户名
}}}

=== 2.25 [=#point225 获取用户信息]===
{{{
url：
   汽车网：http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo (已上线)
   电脑网：http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo (已上线)
作用：同步论坛收藏的内容
使用范围：电脑网app、汽车网app
请求方式：get
是否需要登录：是
请求参数：
 common_session_id:用户登陆后获得的认证id 

返回数据

{
    "nickname":"小小鸟"
    "name":"hahaha“，
    “common_session_id”：“afdsafjlasjfk;asdf”,
    "image":"www.baidu.com/sex.png",    //头像
    "level":"太平洋舰队新兵"    //论坛等级
}
}}}

===  2.26 [=#point226 车型对比结果 ] ===
{{{

url：http://mrobot.pcauto.com.cn/v3/price/detailComparev36?id1=20207&id2=26383 (已上线)

备注：设计稿：http://192.168.50.213/2013.04/App4.0/pcauto/auto_db.html

    请求参数：id1、id2：需要对比的两个车型
    请求方法：get
    是否需要登录：否
}}}

===  2.27 [=#point227 获取车型筛选条件 ] ===
{{{
url：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36/ (已上线)

作用：获取车型的筛选条件。旧版本使用http://mrobot.pcauto.com.cn/v3/price/models/criterion/来获取，
新版本需要获取以下条件：价格、级别、排量、变速箱、属性、结构、燃料、驱动、进气形式、国别、配置和其他，
可参考网站price.pcauto.com.cn。
使用范围：汽车网app
请求方式：get
是否需要登录：否
请求参数：none

返回数据，参考 http://mrobot.pcauto.com.cn/v3/price/models/criterion/


}}}

===  2.28 [=#point228 用户体验计划 ] ===  
{{{
汽车iPhone
http://www.pconline.com.cn/sjzh/ued/app/auto/iphone/
汽车Android
http://www.pconline.com.cn/sjzh/ued/app/auto/android/

电脑iPhone
http://www.pconline.com.cn/sjzh/ued/app/online/iphone/
电脑android
http://www.pconline.com.cn/sjzh/ued/app/online/android/

}}}

=== 2.29 [=#point229 获取产品的相关文章]===
{{{
url：http://mrobot.pconline.com.cn/v3/product/information/485270?pageNo=1 (可内测)
作用：
使用范围：电脑网app
请求方式：get
是否需要登录：否
备注：添加commentNum和pubDate两个字段

请求参数：
 pageSize 每页显示最大记录数
 pageNo 页数

返回数据
{
    "articleList":[
        {
            "channel":"评测",
            "id":"3028852",
            "image":"http://img0.pconline.com.cn/pconline/1210/19/g_3028852_1350644903903.jpg",
            "title":"事实说话 单/双/四核手机使用感受对比",
            "pubDate":"2013-08-02",    // 发布日期
            "commentNum":"2013"        // 评论数
        }
    ],
    "pageCount":424,
    "pageNo":1,
    "pageSize":10,
    "productId":485270,
    "total":4234
}

}}}

=== 2.30 [=#point230 车系总列表]===
{{{
url：http://mrobot.pcauto.com.cn/configs/pcauto_v3_serial_list_for_search (已上线)
作用：
使用范围：汽车网app
请求方式：get
是否需要登录：否
备注：返回所有的车系

请求参数：
 none

返回数据
{
    "list":[
          {"4388":"起亚Venga"},    // key为车系id，value为车系名称
          ......
            ]
}
}}}


== 3.开发时间，负责人及进度汇报==

||批次||= 页面 =||= 需求改动，是否保留该接口 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||=接口进度（百分比）=||=接口实际[[BR]]完成时间=||=接口确认=||
||第一批|| 启动 || 不保留 ||2.1 [#point201 新消息 ] ||- || 论坛同事 ||  - || - || - || 接口确认  
||第一批|| 首页资讯 || 保留 ||2.2 [#point202 栏目页topArticle增加楼层数和图集张数 ] ||- ||mrobot自己可以完成|| - || 已上线  || - || 接口确认  
||第一批|| 个人中心 || 不保留 ||2.3 [#point203 我的帖子 ] ||- || 论坛同事 || - || 可内测  || - || 接口确认  
||第二批|| 个人中心 || 不保留 ||2.4 [#point204 帖子回复 ] ||- || 论坛同事  || - || 可内测 || -  || 接口确认  
||=第二批=|| 个人中心 || 不保留 ||2.5 [#point205 评论回复 ] ||- || 论坛同事、个人中心同事 || - || - || - || 接口确认  
||=第二批=|| 个人中心-收藏夹 || 保留 || 2.6 [#point206 同步内容下载 ] ||- || 个人中心同事  ||-|| 已上线 || - || 接口确认  
||=第二批=|| 个人中心-收藏夹 || 保留 || 2.7 [#point207 同步内容上传 ] ||- || 个人中心同事 ||-|| 已上线 || - || 接口确认  
||=第二批=|| 汽车网论坛首页 || 保留 || 2.8 [#point208 汽车论坛的首页热门 ] ||-|| cms同事  ||-|| 已上线 || - || 接口确认  
||=第二批=|| 帖子列表 || 保留 || 2.9 [#point209 论坛的帖子列表重构 ] ||- || 论坛同事 ||-|| 已上线 || - || 接口确认  
||第三批|| 帖子页 || 保留 || 2.10 [#point210 帖子页 ] ||- || 论坛同事、前端开发同事提供新页面模板  ||-|| 可内测 ||-|| 接口确认  
||第三批|| 回复楼层 || 保留 || 2.11 [#point211 回复楼层 ] ||- || 论坛同事  ||-|| 已上线 ||-|| 接口确认   
||=第四批=|| 电脑网论坛首页 || 保留 ||2.12[#point212 推荐论坛 ]  || - || cms同事 ||-|| - || - || 接口确认
||第一批|| 电脑网论坛首页 || 保留 || 2.13 [#point213 推荐帖子 ] ||- || cms同事 ||-|| 可内测 ||-|| 接口确认  
||第一批|| 图集 || 保留 ||2.14 [#point214 图集列表 ] ||- || cms同事 ||-|| 已上线  || - || 接口确认  
||第一批|| 车型库-选车 || 保留 ||2.15 [#point215 根据价格区间选车 ] ||- || 车型库同事 ||-|| 已上线  || - || 接口确认  
||第二批||车型列表|| 保留 ||2.16 [#point216 车型列表 ] ||- || mrobot自己可以完成  ||-|| 已上线 || -  || 接口确认  
||=第二批=|| 车系相关文章列表 || 保留 ||2.17 [#point217 车系相关文章列表 ]||- || 车型库同事提供相关接口  ||-|| 已上线 || - || 接口确认  
||=第二批=|| 车型详情 || 保留 || 2.18 [#point218 车型概述页修改 ] ||- || 前端开发同事提供新页面模板 ||-|| - || - || 接口确认  
||=第二批=|| 专栏 || 保留 || 2.19 [#point219 专栏页 ] ||- || cms同事负责 ||-|| - || - || 接口确认  
||=第二批=|| 资讯-文章 || 保留 || 2.20 [#point220 文章页 ] ||-|| 前端开发同事提供新页面模板  ||-|| 可内测 ||- || 接口确认
||=第二批=|| 个人中心-帖子回复 || 不保留 || 2.21 [#point221 楼层内容页 ] ||-|| 论坛和个人中心同事  ||-|| 可内测 ||- || 接口确认
||=第二批=|| 车型库-车系列表 || 保留 || 2.22 [#point222 厂商车系列表 ] ||-|| cms同事  ||-|| 已上线 ||- || 接口确认
||=第二批=|| 个人中心-评论回复 || 不保留 || 2.23 [#point223 获取评论内容 ] ||-|| 评论系统同事  ||-|| - ||- || 接口确认
||=第二批=|| 个人中心-修改昵称 || 不保留 || 2.24 [#point224 修改用户昵称 ] ||-|| 论坛同事  ||-|| - ||- || 接口确认
||=第二批=|| 个人中心 || 保留 || 2.25 [#point225 获取用户信息 ] ||-|| 论坛同事  ||-|| 已上线 ||- || 接口确认
||=第二批=|| 车型库-对比结果 || 保留 || 2.26 [#point226 车型对比结果 ] ||-|| cms同事  ||-|| 可内测 ||- || 接口确认
||=第二批=|| 车型库-获取筛选条件 || 保留 || 2.27 [#point227 获取筛选条件 ] ||-|| 快搜同事  ||-|| 已上线 ||- || 接口确认
||=第二批=|| 设置-用户体验计划 || 保留 || 2.28 [#point228 用户体验计划 ] ||-|| 李春杰  ||-|| 已上线 ||- || 接口确认
||=第二批=|| 产品库-获取产品的相关文章 || 保留 || 2.29 [#point229 获取产品的相关文章 ] ||-|| mrobot  ||-|| 可内测 ||- || 接口确认
||=第二批=|| 车型库-车系搜索 || 保留 || 2.30 [#point230 获取车系总列表 ] ||-|| mrobot  ||-|| 已上线 ||- || 接口确认