[[TOC]] = 电脑网4.3.0接口文档 = >mrobot代理环境说明: 192.168.22.242:8888[[BR]] ---------- == 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首页头条 === {{{ 备注:cms需提供条件或者字段让mrobot判断文章的类型,并要增加主播名字段 1)mrobot接口url:http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1 2)后端接口:[[BR]] ios:http://www.pconline.com.cn/app/21json/ 安卓:http://www.pconline.com.cn/android/21json/ HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { "articleList": [ { "bigImage": "http://img0.pconline.com.cn/pconline/c_thumb.jpg", "cmtCount": 0, "id": "1234567", "image": "http://img0.xxx/123.jpg", "imageHor": "http://img0.xxx/1.jpg", "informationType": 8, //8为自媒体 "pubDate": "2015-7-22", "title": "标题标题标题", "url": "http://ivy.pconline.com.cn/xxxxx.html" } ], "focus": [], "pageNo": 1, "pageSize": 20, "topArticle": [ { "image": "http://img.pconline.com.cn/images/8257.jpg", "informationType": 9, //9为视听 "isExtend": "0", "seq": 1, "title": “标题标题标题", //标题 "host": “主播人:唐伯虎", //主播名 "to-uri": "http://g.pconline.com.cn/x/notebook/nbnews/ITnews/nbITnews/?FromApp&type=zt&browser=commonWebView&showShareButton=1", "updateAt": 1442851200000 } ], "topFocus": [], "total": 200 } }}} === 2.2栏目定制=== {{{ 备注:栏目定制增加图片URL 1)mrobot接口url: iOS:http://mrobot.pconline.com.cn/configs/pconline_v7_cms_iphone_channel_tree Android:http://mrobot.pconline.com.cn/configs/pconline_v7_cms_android_channel_tree HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { "news": [ [ "1", "头条", "609", "http://xxx.jpg" //图标地址 ], [ "2", "新闻", "611" "http://xxx.jpg" //图标地址 ], [ "4", "评测", "613", "http://xxx.jpg" //图标地址 ] ], "events": [], "product": [], "area": [] } }}} === 2.3论坛广场=== {{{ 备注:论坛广场每日热帖列表、论坛帖子列表页增加三张缩略图,没有分页一次返回 1)mrobot接口url:http://itbbs.pconline.com.cn/mobile/topics.ajax HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { "desc": "成功", "hot-topics": [ { "createAt": "2015-09-21 13:29:29", "floor": 21, "forumId": 769033, "forumUrl": "http:\/\/itbbs.pconline.com.cn\/mobile\/f769246.html", "lastPostAt": "2015-09-21 15:04:11", "message": “9月18日凌晨我发现爱奇艺A.", "imgUrls": [ "http://imgxxx/c_thumb1.jpg", "http://imgxxx/c_thumb2.jpg", //三张缩略图 "http://imgxxx/c_thumb3.jpg" ], "replyCount": 20, "rewardAmount": 0, "rewardRemain": 0, "title": "【福利】iPhone 6s免费赢取,你的6s手机壳准备好没有??", "topicId": 52494120, "topicUrl": "http:\/\/itbbs.pconline.com.cn\/mobile\/52494120.html", "type": "其他", "userId": 33008677, "userName": “进阶强者", //用户名 "userImage": “", //用户头像 "userUrl": "http:\/\/my.pconline.com.cn\/33008677", "viewCount": 15430 } ] } }}} === 2.4视频广告=== {{{ 备注:广告系统新增视频音频标识(isMedia=1表示带视频或音频的广告,isMedia=0表示普通广告) 1)mrobot接口url:http://mrobot.pconline.com.cn/s/onlineinfo/ad/ad.xsp 2)后端接口:[[BR]] http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.zx4.&media=js HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { "twlb1": [ { "seq": "5", "informationType": "7", "isMedia": “1", //判断是否包含视频、音频 "image": "http://imgad0.pconline.com.cn/ivy/image/20154/2/14279648642540.jpg", "imageHor": "http://imgad0.pconline.com.cn/ivy/image/20158/5/14387708428240.jpg", "title": "首页图文列表第5位", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=362147&id=test.xwx.khd.zx.zx5.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=362147&id=test.xwx.khd.zx.zx5.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ], "jdt1": [ { "seq": "3", "informationType": "7", "isMedia": “0", //判断是否包含视频、音频 "image": "http://imgad0.pconline.com.cn/ivy/image/20158/3/14385953043150.jpg", "title": "LG G4奢华真皮版天猫上市 送多重好礼", "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=376156&id=pc.khd.zx.jdt.&media=js", "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=376156&id=pc.khd.zx.jdt.", "vc3d-uri": "", "cc3d-uri": "", "cc-uri": "" } ] } }}} === 2.5启动页=== {{{ 备注:Android因为不需要适配不同分辨率的机型,因此默认读取image字段,IOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置,当启动图过期时image字段返回为空即可 1)mrobot接口url:http://mrobot.pconline.com.cn/pconline/skin HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { //默认启动图 "image":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg", //IOS的启动图 "ios":{ // 针对I4以下机型 "i4":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg", //针对I5机型 "i5":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg", //针对I6机型 "i6":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg", //针对I6+机型 "i6p":"http://www.sinaimg.cn/qc/photo_auto/photo/50/11/1485011/1485011_src.jpg" } } }}} === 2.6搜索关键字接口=== {{{ 备注:热门图集最多返回4个,热门新闻最多返回10条(在mrobot控制,后期变动直接改mrobot接口即可)。客户端拿到数据直接显示 1)mrobot接口url:http://mrobot.pconline.com.cn/search/keyword HTTP请求方式:get 是否需要登录:否 返回格式:JSON 是否有缓存:有 返回参数: { "hot_keyword": "魅族", "hot_photo": [ { "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测", //标题 "image": "http: //img0.xxx/123.jpg", "to-uri": "pconlinebrowser://album-photo/14686", "imgCount": 15, "isExtend": "0", "preView": "文字文字文字", "pubDate": "2015-7-22", "updateAt": 1437494400000 }, { "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测", "image": "http://img0.xxx/123.jpg", "to-uri": "pconlinebrowser://album-photo/14686", "imgCount": 15, "isExtend": "0", "preView": "文字文字文字", "pubDate": "2015-7-22", "updateAt": 1437494400000 } ], "hot_news": [ { "id": "1234567", "cmtCount": 0, "image": "http://img0.xxx/123.jpg", "pubDate": "2015-7-22", "title": "标题标题标题", "url": "http://ivy.pconline.com.cn/xxxxx.html" }, { "id": "1234567", "cmtCount": 0, "image": "http://img0.xxx/123.jpg", "pubDate": "2015-7-22", "title": "标题标题标题", "url": "http://ivy.pconline.com.cn/xxxxx.html" } ] } }}} ----------