pconline_4.0.0/interface – iphone

wiki:pconline_4.0.0/interface

Context Navigation

Version 22 (modified by wuchangbo, 11 years ago) (diff)
--

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存，对象缓存
缓存时间：缓存时间
返回结果：结果可能情况

2.接口列表

2.1 首页 - 资讯列表

备注：此接口返回资讯消息列表，在返回字段里增加资讯类型

informationType = 0, 其他 informationType = 1, 文章 informationType = 2, 帖子 informationType = 3, 图集 informationType = 4, 新增直播类型 informationType = 5, 新增专题类型 informationType = 6, 新增聚超值类型 informationType = 7 推广类型(广告)要求：1、17-18.5字， 2、加“推广”标签，3、要求能打开自己文章页也可以用webview打开客户指定网页。专题类型时，to-uri字段指定专题页网址，且必须包含“type=zt”(旧版本就已经规定过);而且必须包含“browser=commonWebView”参数（表示用专题webview打开）;参数“showShareButton={0或者1}”表示是否显示分享按钮，0不显示，1显示 mrobot接口： http://mrobot.pconline.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20 后端接口：无 HTTP请求方式：get 是否需要登录：否返回格式：json 缓存方式：无缓存时间：无请求参数：

pageNo=页码 pageSize=一页条数，默认20，最大500

返回参数： {

"articleList": [ 备注：此处无专题类型

{

"bigImage": " http://img0.pconline.com.cn/pconline/1409/19/5460676_51_1k6tu9yn_thumb.jpg", "cmtCount": 文章评论数, "id": 文章id, "image": 文章图片地址, "pubDate": 发布时间, "title": 标题, "url": 文章详情地址, "informationType": 资讯类型

}

], "focus": [ 备注：此处无专题类型

{

"counter": "", "id": 文章id, "image": 文章图片地址_{"pubDate": 发布时间,
"title": 标题,
"url": 文章详情地址,
"informationType": 资讯类型}

}

], "topArticle": [ 备注：只有这里有专题类型

{

"image": " http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg", "preView": "其他类型的资讯，用全屏webview打开，类似聚超值类型", "pubDate": "2014-10-09", "seq": 7, "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低", "to-uri": " http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265", "updateAt": 1412784000000, "informationType": 0 其他类型

}, {

"cmtCount": 26, "image": " http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c4/39422400_1412824208134_1024x1024.jpg", "preView": "64位双4G快时代！酷比魔方&联发科技4G战略发布会", "pubDate": "2014-10-09", "seq": 8, "title": "快时代！酷比魔方&联发科技4G战略发布会参与互动送平板", "to-uri": "pconlinebrowser://information-article/322?template=live", "updateAt": 1412784000000, "informationType": 1 文章类型

}, {

"floorCount": 9, "image": " http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c3/39418150_1412820169882_1024x1024.jpg", "preView": "HTC发布的奇特造型RE相机新品，你喜欢吗？", "pubDate": "2014-10-09", "seq": 5, "title": "HTC发布的奇特造型RE相机新品，你喜欢吗？", "to-uri": "pconlinebrowser://bbs-topic/51812318", "updateAt": 1412784000000, "informationType": 2 论坛类型

}, {

"image": " http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c5/39426075_1412827383297_1024x1024.jpg", "imgCount": 17, "preView": "HTC Desire Eye手机和RE相机图赏\t", "pubDate": "2014-10-09", "seq": 6, "title": "HTC Desire Eye手机和RE相机图赏\t", "to-uri": "pconlinebrowser://album-photo/13404", "updateAt": 1412784000000, "informationType": 3 图集类型

}, {

"cmtCount": 279, "image": " http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/08/c6/39379595_1412740065734_1024x1024.jpg", "preView": "[图文直播]HTC自拍神器旗舰新品发布会", "pubDate": "2014-10-09", "seq": 12, "title": "HTC自拍神器旗舰新品发布会回顾 Desire Eye手机及RE相机发布", "to-uri": "pconlinebrowser://information-article/323?template=live", "updateAt": 1412784000000, "informationType": 4 直播类型

}, {

"image": " http://img0.pcauto.com.cn/pcauto/1410/03/g_5242861_1412322026811_240x160.jpg", "preView": "2014巴黎车展：12款重磅SUV/即将引进", "pubDate": "2014-10-09", "seq": 17, "title": "2014巴黎车展：12款重磅SUV/即将引进", "to-uri": " http://www1.pcauto.com.cn/app/cheshi/index.html?type=zt&fromapp=1&browser=commonWebView", "updateAt": 1412784000000, "informationType": 5 专题类型

}, {

"image": " http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg", "preView": "今日聚超值", "pubDate": "2014-10-09", "seq": 7, "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低", "to-uri": " http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265", "updateAt": 1412784000000, "informationType": 6 聚超值类型

}

],

"topFocus": [ 备注：此处无专题类型

{

"cc-uri": "", "image": " http://imgad0.pconline.com.cn/ivy/image/20149/25/14116394470770.jpg", "seq": 3, "title": "广告", "to-uri": " http://ivy.pconline.com.cn/adpuba/click?adid=334508&id=pc.khd.zx.jdt.", "updateAt": 1412824722772, "vc-uri": " http://ivy.pconline.com.cn/adpuba/show?adid=334508&id=pc.khd.zx.jdt.&media=js"

}

], ... "total": 文章总数量

}

栏目配置

iOS: http://mrobot.pconline.com.cn/configs/pconline_v4_cms_iphone_channel_tree
Android: http://mrobot.pconline.com.cn/configs/pconline_v4_cms_android_channel_tree

判断板块是否收藏

URL：http://itbbs.pconline.com.cn/action/user/check_favorite.jsp

参数：fid //版块ID

是否要求登陆：是

方法：POST

返回结果：
-1：参数错误/未登陆/非post提交/未收藏
2806152: 收藏id

个人中心推广活动

URL：http://mrobot.pconline.com.cn/v2/cms/proxy?uri=http://app.pconline.com.cn/appnews/tghd/1403/intf4501.js
说明：uri参数部分需要按百分号转义
返回
{"data":
         [
              {
                  "title":"2014年日内瓦国际车展实时报道",
                  "to-uri":"http://www1.pcauto.com.cn/mobile/2014rineiwachezhan/rineiwa/rineiwa.html?browser=commonwebview"
              }
         ]
}

论坛树

论坛配置 http://mrobot.pconline.com.cn/configs/pconline_v4_bbs_forum_tree
增加最数码板块

层次结构:(id使用负数区分是否最数码论坛，对于最数码论坛使用不同的接口，使用实请自行把id转为正数)
最数码论坛 id -2
      二手闲置交易 id -48
      水聊地带 id -72

最数码－发帖

URL：http://mrobot.pconline.com.cn/proxy/piebbs/forums/76
参数：参考现有itbbs的发帖接口
返回：参考现有itbbs的发帖接口

最数码－回帖

URL：http://mrobot.pconline.com.cn/proxy/piebbs/topics/82417
参数：参考现有itbbs的回帖接口
返回：参考现有itbbs的回帖接口

最数码－帖子终端页

URL：http://mrobot.pconline.com.cn/v2/piebbs/topics/82417?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=3.6.0&app=pconlinebrowser&size=18
参数：参考现有itbbs的帖子页
返回：参考现有itbbs的帖子页

最数码－热门帖子列表（待确认）

URL：http://mrobot.pconline.com.cn/proxy/piebbs/forums/2

最数码－帖子列表

URL：
http://mrobot.pconline.com.cn/v2/piebbs/forums/48?&pageNo=1&pageSize=25&orderby=replyat 最后回复
http://mrobot.pconline.com.cn/v2/piebbs/forums/48?&pageNo=1&pageSize=25&orderby=postat 最后发表
http://mrobot.pconline.com.cn/v2/piebbs/forums/48?pageNo=1&pageSize=25&filter=pick 精华
http://mrobot.pconline.com.cn/v2/piebbs/forums/48?pageNo=1&pageSize=25&filter=top 置顶
参数：参考现有itbbs的帖子列表，48是板块id
返回：参考现有itbbs的帖子列表

最数码－板块是否收藏

URL：http://piebbs.pconline.com.cn/action/user/check_favorite.jsp
参数：参考上述“判断板块是否收藏”这一节
返回：参考上述“判断板块是否收藏”这一节

同步内容下载

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:页码

注：seriesList，modelList为汽车网客户端独有，
      pieForumList, pieTopicList为电脑网客户端独有
例子：
｛
           "pieforumCount":0, //接口出分页较为麻烦，最数码论坛本字段无效
           "pieforumPageCount":0, //接口出分页较为麻烦，最数码论坛本字段无效
           "pietopicCount":0, //接口出分页较为麻烦，最数码论坛本字段无效
           "pietopicPageCount":0, //接口出分页较为麻烦，最数码论坛本字段无效
           "forumCount":0,
           "forumPageCount":0,
           "topicCount":0,
           "topicPageCount":0,
           "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系太好了”, //帖子标贴
            	 }
            ],
                 “pieForumList”:[//最数码论坛
            	 {
			“id”:1234,  //收藏id
                        “forumId”：145，//论坛版块id
  	 	 	“name”:”宝马”, //论坛名字
           	  },
            	 {
	 	 	“id”:1234,  //收藏id
                        “forumId”：145，//论坛版块id
  	 	 	“name”:”宝马”, //论坛名字
            	 }
            ],
		 “pieTopicList”:[//最数码帖子
            	 {
			“id”:1234,  //收藏id
                        “topicId”：145，//帖子id
  	            	“name”:”宝马3系太好了”, //帖子标贴
		},
             	{
			“id”:1234,  //收藏id
                        “topicId”：145，//帖子id
  	                “name”:”宝马3系太好了”, //帖子标贴
            	 }
}

同步内容上传

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

请求方式：post
是否需要登录：是
请求参数：
 common_session_id:用户登陆后获得的认证id 
 json：需要上传的数据提交给该参数。
注：series，model为汽车网客户端独有
      pieforum, pietopic为电脑网客户端独有

例子：
           ｛
          “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字段

          }
          “pieforum”:{ //论坛
		“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组，此处的id即为同步下载接口中的forumId
		“deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中forumList下的id字段
                    },
          “pietopic”:{ //帖子
		“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组，此处的id即为同步下载接口中的topicId
		“deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中topicList下的id字段

          }
}

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 首页 - 资讯列表

栏目配置

判断板块是否收藏

个人中心推广活动

论坛树

最数码－发帖

最数码－回帖

最数码－帖子终端页

最数码－热门帖子列表 （待确认）

最数码－帖子列表

最数码－板块是否收藏

同步内容下载

同步内容上传

Download in other formats:

最数码－热门帖子列表（待确认）