wiki:pconline_4.3.0/interface

电脑网4.3.0接口文档

mrobot代理环境说明:

192.168.10.198:1080(192.168.74.80) 192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)


1.接口列表


1.1首页头条

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1&appVersion=4.3.0
后端接口:
ios: http://www.pconline.com.cn/app/21json/
android: http://www.pconline.com.cn/android/21json/
说明

1.cms在21json接口提供栏目id字段让mrobot判断“自媒体”文章的类型;
2.madmin增加一个为“视听”的头条文章类型,并增加主播名字段,由编辑录入。录入的时候,要注意一下:

type=shiting 参数必须,表示是视听类型,与之前专题的规则一样
browser=commonWebView 参数必须,表示是调用专题那个公共webView打开
showShareButton=1 参数必须,表示是否显示分享按钮,1为显示,0为不显示

链接例子:  http://g.pconline.com.cn/x/notebook/nbnews/ITnews/nbITnews/?FromApp&type=shiting&browser=commonWebView&showShareButton=1

缓存时间

5min

提交方式

GET

是否登录

数据来源

cms、madmin

参数

参数名 参数含义 类型 默认值 是否必需 说明
pageNo页码string 页码
pageSize每页条数string 每页条数
appVersion版本号string 版本号

返回

{
    "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": “标题标题标题",     
            "anchor": “主播人:唐伯虎",    //主播名
            "to-uri": "http://g.pconline.com.cn/x/notebook/nbnews/ITnews/nbITnews/?FromApp&type=zt&browser=commonWebView&showShareButton=1",
            "updateAt": 1442851200000
        }
    ],
    "topFocus": [],
    "total": 200
}

返回参数说明

参数名 参数含义
anchor主播名 新增字段,当informationType=9为视听类型时才会返回该字段
informationType0:其他 1:文章 2:帖子 3:图集 4:直播 5:专题 6:聚超值 7:推广 8:自媒体(新增字段) 9:视听(新增字段)

1.2栏目定制

(mrobot已完成开发,请连开发机进行测试)
mrobot接口:
iOS: http://mrobot.pconline.com.cn/configs/pconline_v8_cms_iphone_channel_tree
Android: http://mrobot.pconline.com.cn/configs/pconline_v8_cms_android_channel_tree
说明

栏目定制增加图片URL

缓存时间

提交方式

GET

是否登录

数据来源

madmin

参数

返回

{
    "news": [
        [
            "1",
            "头条",
            "609",
            "http://xxx.jpg"    //图标地址(新增字段)
        ],
        [
            "2",
            "新闻",
            "611"
            "http://xxx.jpg"    //图标地址(新增字段)
        ],
        [
            "4",
            "评测",
            "613",
            "http://xxx.jpg"    //图标地址(新增字段)
        ]
    ],
    "events": [],
    "product": [],
    "area": []
}

返回参数说明

参数名 参数含义

1.3论坛广场——每日热帖

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s-900/onlineinfo/bbs/topics.xsp?type=hot_day&forums=8,2,240024,41&singleForum=false&noForums=762423,2312647&ie=utf-8&count=20&showImage=true&size=240x180
后端接口: http://itbbs.pconline.com.cn/mobile/topics.ajax
说明

论坛广场每日热帖列表显示前三张缩略图(缩略图截取原图中间部分),没有分页一次返回(客户端本地做分页,20条数据一页),列表接口需要做去重处理,【去重规则:帖子标题一样的。按回帖数最多的显示】,同时屏蔽摄影论坛的内容

缓存时间

15min

提交方式

GET

是否登录

数据来源

论坛后台

参数

1. singleForum=false;

当singleForum=false,支持多个版块(输出结果按传递的fid顺序输出),参数如下:

noForums=0;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
forums=1;需要查询的版块ID,多个版块ID用半角逗号分隔。查找的信息也会包含其子版块
type=hot_day;查询类型。目前支持new(2日内新帖),new_act(2日内活动帖),new_vote(2日内投票帖),hot_day(2日内热帖),hot_week(7日内热帖),hot_month(30日内热帖),hot_all(全部热帖),pick_day(2日内精华帖),pick_week(7日内精华帖),pick_month(30日内精华帖),pick_all(全部精华帖)
orderby=;查询类型为hot时,默认按回复数(replyCount)排序,要按点击数(view)排序就需要加此配置。查询类型为pick,new时,默认按发帖时间(createAt)排序,要按点击数(view)排序就需要加此配置。
count=10;要输出的条数
pickType=pickA;精华类型,可填pickA,pickB,pick1,pick2,pick3,pick4,pick5;其中pickA和pickB查的都是普通精华
size=;显示主题前3张图片的尺寸。可选400x、240x180、120x90

当singleForum=true,支持一个版块,参数如下:

forums=1;只能接受一个版块ID,多个版块取第一个
days=2;从多少天前的数据开始查询,可填任意整数
type=hot;可填new,hot,pick
reply=-1;回复数大于等于多少,为-1时没有限制
replyMax=-1;回复数最大是少于多少,为-1时没有限制
category=;话题类别,默认为不填
pickType=common;当type=pick时,pickType可为all(全部精华),common(普通精华),extendAll(全部扩展精华),pick1,pick2,pick3,pick4,pick5
pageSize=10;每页列出的条数
pageNo=1;当前页

2. maxLength=240;帖子内容最大长度,默认240个英文字符,相当于120个汉字.
3. callback=;回调函数名称
4. showImage=false;是否显示主题的第一张图片URL

返回

{
    "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
        }
    ]
}

返回参数说明

参数名 类型 参数含义
imgUrls数组缩略图(最多返回三张,如果没有缩略图则无需返回)

1.4论坛帖子列表

(mrobot已完成开发,请连开发机进行测试)
mrobot接口:(电脑网论坛)  http://mrobot.pconline.com.cn/v3/itbbs/newForums/769285?orderby=replyat&pageSize=20&pageNo=1&maxLength=200

(最数码论坛)  http://mrobot.pconline.com.cn/v2/piebbs/forums/2

后端接口:(电脑网论坛)  http://itbbs.pconline.com.cn/rest/forums/769285?orderby=replyat&pageSize=20&pageNo=1&maxLength=200

(最数码论坛)  http://piebbs.pconline.com.cn/rest/forums/2

说明

具体版块下帖子列表,接口后面拼接论坛ID。返回数据帖子列表页显示前三张缩略图(缩略图截取原图中间部分),分页返回。

缓存时间

提交方式

GET

是否登录

数据来源

论坛后台

参数

参数名 参数含义 类型 默认值 是否必需 说明
pageNo页码string 页码
pageSize每页条数string 每页条数
orderby排序方式string 最后回复replyat 最后发表postat
filter 类型string 精华pick 置顶top
maxLength类型string 控制message字段中的数字

返回

{
    "topicList": [
        {
    "author": {
        "name": "sn32437094",
        "nickname": "叶小文",
        "userFace": "http://i7.3conline.com/images/upload/upc/face/32/43/70/94/32437094_50x50",
        "userId": 32437094
    },
    "createAt": 1444724599000,
    "flag": "图",
    "floor": 5,
    "formatCreateAt": "23小时前",
    "image": "http://imgm.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c3/13905357_1444724567086_1024x1024it.jpg",
    "imgUrls": [
        "http://img.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c3/13905357_1444724567086_400x.jpg",
        "http://img.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c2/13904602_1444723996957_400x.jpg",
        "http://img.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c2/13904603_1444723999417_400x.jpg",
        "http://img.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c2/13904447_1444724001952_400x.jpg",
        "http://img.pconline.com.cn/images/upload/upc/tx/piebbs/1510/13/c2/13904448_1444724004206_400x.jpg"
    ],
    "isContainImage": true,
    "lastPoster": {
        "lastPostAt": "2分钟前",
        "name": "gkimstxtg",
        "nickname": "自己给自己打工!!!!!!!",
        "userId": 7046632
    },
    "message": "",
    "replyCount": 4,
    "title": "一加手机2(开箱),让质感变为现实!",
    "topicId": 143865,
    "uri": "http://piebbs.pconline.com.cn/topic-143865.html",
    "view": 395
}
    ]
}

返回参数说明

参数名 类型 参数含义
imgUrls数组缩略图(最多返回三张,如果没有缩略图则无需返回)

1.5视频广告

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s/onlineinfo/ad/ad.xsp
后端接口: http://ivy.pconline.com.cn/adpuba/show?id=pc.khd.zx.zx4.&media=js
说明

广告系统新增视频音频标识(isMedia=1表示带视频或音频的广告,isMedia=0表示普通广告)

缓存时间

提交方式

GET

是否登录

数据来源

广告系统

参数

参数名 参数含义 类型 默认值 是否必需 说明
platform平台标识string android平台,platform=android;ios平台,platform=ios
deviceModel设备机型string 设备机型

返回

{
    "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": ""
        }
    ]
}

返回参数说明

参数名 参数含义
isMedia0:表示普通广告 1:表示多媒体广告

1.6启动页

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s-900/onlineinfo/cms/launch.xsp
后端接口: http://www.pconline.com.cn/app/1510/intf11121.html
说明

Android因为不需要适配不同分辨率的机型,因此默认读取image字段,IOS那边则需要判断返回的JSON数据是否有’ios’这个属性,有则读取对应的倍图,没有则读取image字段,过期时间CMS后台设置,当启动图过期时返回空白图

缓存时间

15min

提交方式

GET

是否登录

数据来源

参数

返回

{
      //默认启动图
      "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"
       }
}

返回参数说明

参数名 参数含义
imageAndroid因为不需要适配不同分辨率的机型,因此默认读取image字段。为空则表示启动图过期或不存在
iosIOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置,当启动图过期时image字段返回为空即可(下面是对应IOS不同机型需要读取的字段)
i4针对I4以下机型(IOS客户端)
i5针对I5以下机型(IOS客户端)
i6针对I6以下机型(IOS客户端)
i6p针对I6+以下机型(IOS客户端)

1.7搜索关键字接口

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s-900/onlineinfo/cms/hotKeyword.xsp
后端接口: http://www.pconline.com.cn/app/1510/intf11141.html
说明

备注:热门图集最多返回4个,热门新闻最多返回10条

缓存时间

15min

提交方式

GET

是否登录

数据来源

cms

参数

返回

{
    "hot_keyword": "魅族", //关键词
    "hot_photos": [//图集
        {
            "id": "14686", //图集id
            "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",
            "image": "http: //img0.xxx/123.jpg"
        },
        {
            "id": "14686",
            "title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",
            "image": "http://img0.xxx/123.jpg"
        }
    ],
    "hot_news": [//文章
        {
            "id": "1234567",//文章id
            "cmtCount": 2,//评论数
            "image": "http://img0.xxx/123.jpg",
            "pubDate": "2015-7-22",
            "title": "标题标题标题"
        },
        {
            "id": "1234567", 
            "cmtCount": 4,
            "image": "http://img0.xxx/123.jpg",
            "pubDate": "2015-7-22",
            "title": "标题标题标题"
        }
    ]
}

返回参数说明

参数名 参数含义
hot_keyword搜索框关键字(只会返回一个)
hot_photo热门图集(以下三个参数是hot_photo段)
title标题
to-uri图集跳转协议
image图片URL
hot_news热门新闻(以下三个参数是hot_news段)
id新闻ID
cmtCount评论数
image图片URL
pubDate发表时间
title新闻标题
url文章跳转协议

1.8文章终端页模板配置接口

(mrobot已完成开发,请连开发机进行测试)
mrobot接口:
iOS: http://mrobot.pconline.com.cn/configs/pconline_iphone_article_auto_update.json
Android: http://mrobot.pconline.com.cn/configs/pconline_android_article_auto_update.json

文章页接口:  http://mrobot.pconline.com.cn/v3/cms/articles/7077657?articleTemplate=3.6.0&size=18&picRule=2&app=pconlinebrowser&template=(null)&channelId=1&serialId=0&appVersion=4.3.0&platform=ios&deviceModel=&resVer=44000

说明

目前的资讯文章终端页太大,拆分成css、js和html主体两个部分,其中css、js放客户端本地,html主体由mrobot接口给出;客户端需支持在线更新css、js功能

缓存时间

提交方式

GET

是否登录

数据来源

参数

文章页接口在原参数基础上,新增以下参数

参数名 参数含义 类型 默认值 是否必需 说明
resVer资源包版本号int0资源包版本号,例子:43000

返回

{
     date: "2015-09-21 17:00:00",      
     patch-uri: "",                   
     patch-md5: "",                    
     resVer: 43000,                   
     description: ""                  
}

返回参数说明

参数名 参数含义
date更新时间
patch-uri下载地址
patch-md5md5校验串
resVer版本号
description描述

1.9文章终端页一页加载

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/v3/cms/articles/7049937?articleTemplate=3.6.0&channelId=999&size=18&picRule=2&app=pconlinebrowser&template=(null)&appVersion=4.3.0&platform=android&deviceModel=SM-G9008V&resVer=43001

说明

1、文章在小于等于3页时,分页锚点按钮不需要出现;

2、文章大于3页时,文章页顶部出现锚点分页按钮,点击可弹出分页弹出层,点击小标题跳转该页锚点位置,锚点置顶。
3、文章依旧保持一页加载,并按需加载。

缓存时间

提交方式

GET

是否登录

数据来源

参数

参数名 类型 必须 说明
articleTemplateint3.6.0(固定不变)
channelIdint栏目ID
sizeint字体大小
picRulestring0小图,1无图,2大图
appstringpconlinebrowser(固定不变)
templatestring(null)(固定不变)
appVersionstring版本号
platformstring平台 android为platform=android,IOS为platform=ios
deviceModelstring手机型号(只有android手机)
resVerstring资源包版本号。resVer=43001,此版本号由app版本号和资源包迭代版本构成,如资源包第一版,resVer=43001;资源包第二版,resVer=43002,如此类推

返回 HTML页面里面的源码里面内嵌有JSON数据(内嵌JSON数据以/*@_HTML_META_START_开头并以_HTML_META_END_@*/,客户端自行读取)

{
    "author": "lulijian",
    "firstPic": "http://img0.pconline.com.cn/pconline/1510/12/7045017_Screenshot_2015-10-12-13-23-07_thumb.png",
    "guidePic": "http://img0.pconline.com.cn/pconline/1509/30/g_7018278_1443581718563.jpg",
    "pageCount": 3,
    "pageNo": 2,
    "pages": [
        "Moto 360二代外观:颜值依旧称霸",
        "Android Wear 中国版:惨遭阉割",
        "Moto 360二代体验总结"
    ],
    "preView": "【PConline 评测】自第一代Moto 360发布以来,它就成为了Android Wear的标杆性产品,",
    "pubDate": "2015-10-13",
    "readonly": 0,
    "summary": "【PConline 评测】自第一代Moto 360发布以来,它就成为了Android Wear的标杆性产品,当然它也是很多用户心目中颜值最高的智能手表之一,其呼声甚至超过了如日中天的苹果产品Apple Watch。不断推陈出新是数码界的自然法则,而最近Moto 360已经推出了第二代产品,并且又在诸多细节上进行了调整。对于国内用户来说,更加喜人的是,Moto 360二代在国内进行了重新定制,并且也已经发布。PConline也在第一时间拿到了这款备受瞩目的产品。今天我们就带大家来实际体验一下这款产品,究竟这国内版的Moto 360二代好不好用。",
    "thumbPic": "http://img0.pconline.com.cn/pconline/1510/12/7045017_Screenshot_2015-10-12-13-23-07_thumb.png",
    "title": "颜值始终称霸!Moto360二代智能手表体验",
    "url": "http://wearable.pconline.com.cn/701/7018278.html",
    "wap_url": "http://g.pconline.com.cn/x/701/7018278.html",
    "androidResVer":43000,    //android当前JS模板版本号
    "iphoneResVer":43000      //ios当前JS模板版本号
}

锚点参数说明

锚点名为#content_page_{pageNum},如"Moto360二代外观:颜值依旧称霸"的URL为
 http://mrobot.pconline.com.cn/v3/cms/articles/7049937?articleTemplate=3.6.0&channelId=999&size=18&picRule=2&app=pconlinebrowser&template=(null)&appVersion=4.3.0&platform=android&deviceModel=SM-G9008V&resVer=43001#content_page_2 如此类推..


=== 1.10 3D Touch文章列表预览===
mrobot接口: http://mrobot.pconline.com.cn/xx?id=7087724

说明

1、根据文章id返回文章预览概要;

缓存时间

提交方式

GET

是否登录

数据来源

参数

参数名 类型 必须 说明
idint文章id

返回

{
    "status": 0,
    "msg": "请求成功",
    "data": [
        {
            "title": "终兼容Office2016!OSX10.11.1更新发布",
            "articleId": "7087724",
            "summary": "200字以内的概述。",
            "image": "http://img0.pconline.com.cn/pconline/1510/22/g_7087724_1445487789227.jpg",
            "pubDate": "10月22日",
            "url": "http: //pcedu.pconline.com.cn/708/7087724.html"
        }
    ]
}

=== 1.11 3D Touch帖子列表预览===
mrobot接口: http://mrobot.pconline.com.cn/xx?id= 52548976

说明

1、根据帖子id返回帖子预览概要;

缓存时间

提交方式

GET

是否登录

数据来源

参数

参数名 类型 必须 说明
idint文章id

返回

{
    "status": 0,
    "msg": "请求成功",
    "data": [
        {
            "title": "Android设备芯片品牌分布比例,联芯崭露头角,淫威大已出局!",
            "topicId": "52548976",
            "summary": "80字以内的概述。",
            "image": "http://img0.pconline.com.cn/pconline/1510/22/g_7087724_1445487789227.jpg", //帖子的第一张图,如果没有就为空
            "url": "http://itbbs.pconline.com.cn/mobile/52548976.html"
        }
    ]
}

1.12 举报终端页

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s/onlineinfo/bbs/report.xsp?isBBS=1&topicId=52553893&postId=526010636
后端接口: http://bbs.pconline.com.cn/action/post/reportAbuse.do

缓存时间

提交方式

POST

是否登录

数据来源

参数

参数名 类型 必须 说明
isBBSstring判断举报是否来自帖子终端页,isBBS=1时来自帖子;isBBS=0时来自文章
topicIdstring帖子id或文章id
postIdstring楼层id,当举报来自文章评论时postId=0

返回 HTML


1.13 协议终端页

(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s-86400/onlineinfo/cms/protocol.xsp

缓存时间

24h

提交方式

get

是否登录

数据来源

参数

返回 HTML

1.14 帖子终端页

mrobot接口: http://mrobot.pconline.com.cn/v2/itbbs/topics/52582918?pageNo=1&picRule=2&authorId=0&topicTemplate=3.6.0&app=pconlinebrowser&appVersion=4.3.0&size=20

说明

为配合苹果审核,审核期间帖子终端要出“举报”按钮,上线之后隐藏。该版本此接口新增一个可选参数inreview,当inreview=1时显示“举报”按钮,其他情况均隐藏“举报”按钮。

新增参数

参数名 类型 必须 说明
inreviewstring可选当inreview=1时,帖子显示“举报”按钮,其他情况均隐藏“举报”按钮

返回 HTML