pcauto_pconline_4.0.0/intf – iphone

wiki:pcauto_pconline_4.0.0/intf

Context Navigation

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日才上线，故电脑网论坛和个人中心的接口需使用测试环境接口，所以客户端同事测试时请登陆测试环境。
电脑网论坛测试环境首页如为： http://v26.pconline.com.cn/index.do 用户名：baidu，密码：123456
请使用common_session_id1，而非common_session_id

2.1 新消息

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

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

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

2.2 栏目页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 我的帖子

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 帖子回复

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 评论回复

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 同步内容下载

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 同步内容上传

   汽车网：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 汽车论坛的首页热门

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

    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 新版帖子页

    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 回复楼层

    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 推荐论坛

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

2.13 推荐帖子

    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 图集列表

    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 根据价格区间选车

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

    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 车系相关文章列表

    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车型概述页修改

    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专栏页

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

2.20文章页

    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楼层内容页

    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厂商车系列表

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

2.23获取评论内容

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

2.24 修改用户昵称

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

2.25 获取用户信息

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 车型对比结果

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 获取车型筛选条件

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 用户体验计划

汽车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 获取产品的相关文章

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 车系总列表

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

请求参数：
 none

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

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

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

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 新消息

2.2 栏目页topArticle增加楼层数和图集张数

2.3 我的帖子

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 车系总列表

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

Download in other formats: