![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 13 (modified by wuchangbo, 11 years ago) (diff) |
|---|
Table of Contents
电脑网4.3.0接口文档
mrobot代理环境说明：
192.168.22.242:8888
1.接口列表
1.1首页头条
mrobot接口： http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
后端接口：
ios： http://www.pconline.com.cn/app/21json/
安卓： http://www.pconline.com.cn/android/21json/
说明
cms需提供条件或者字段让mrobot判断文章的类型，并要增加主播名字段
缓存时间
无
提交方式
GET
是否登录
否
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必需 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页码 | string | 页码 | ||
| pageSize | 每页条数 | 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": “标题标题标题", //标题
"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
}
返回参数说明
| 参数名 | 参数含义 |
|---|---|
| host | 主播名 新增字段,当informationType=9为视听类型时才会返回该字段 |
| informationType | 0:其他 1:文章 2:帖子 3:图集 4:直播 5:专题 6:聚超值 7:推广 8:自媒体(新增字段) 9:视听(新增字段) |
1.2栏目定制
mrobot接口：
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
说明
栏目定制增加图片URL
缓存时间
无
提交方式
GET
是否登录
否
数据来源
无
参数
无
返回
{
"news": [
[
"1",
"头条",
"609",
"http://xxx.jpg" //图标地址(新增字段)
],
[
"2",
"新闻",
"611"
"http://xxx.jpg" //图标地址(新增字段)
],
[
"4",
"评测",
"613",
"http://xxx.jpg" //图标地址(新增字段)
]
],
"events": [],
"product": [],
"area": []
}
返回参数说明
| 参数名 | 参数含义 |
|---|
1.3论坛广场
mrobot接口： http://itbbs.pconline.com.cn/mobile/topics.ajax
说明
论坛广场每日热帖列表、论坛帖子列表页显示前三张缩略图(缩略图截取原图中间部分)，没有分页一次返回(客户端本地做分页，20条数据一页),列表接口需要做去重处理，【去重规则：帖子标题一样的。按发帖时间最早的显示】同时屏蔽摄影论坛的内容
缓存时间
无
提交方式
GET
是否登录
否
数据来源
论坛后台
参数
无
返回
{
"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接口： 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
是否登录
否
数据来源
无
参数
无
返回
{
"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": ""
}
]
}
返回参数说明
| 参数名 | 参数含义 |
|---|---|
| isMedia | 0：表示普通广告 1:表示多媒体广告 |
1.5启动页
mrobot接口： http://mrobot.pconline.com.cn/pconline/skin
说明
Android因为不需要适配不同分辨率的机型，因此默认读取image字段，IOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置，当启动图过期时image字段返回为空即可
缓存时间
无
提交方式
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"
}
}
返回参数说明
| 参数名 | 参数含义 |
|---|---|
| image | Android因为不需要适配不同分辨率的机型，因此默认读取image字段。为空则表示启动图过期或不存在 |
| ios | IOS那边则需要判断返回的JSON数据是否有’ios’这个属性有则读取对应的倍图没有则读取image字段过期时间CMS后台设置，当启动图过期时image字段返回为空即可（下面是对应IOS不同机型需要读取的字段) |
| i4 | 针对I4以下机型(IOS客户端) |
| i5 | 针对I5以下机型(IOS客户端) |
| i6 | 针对I6以下机型(IOS客户端) |
| i6p | 针对I6+以下机型(IOS客户端) |
1.6搜索关键字接口
mrobot接口： http://mrobot.pconline.com.cn/search/keyword
说明
备注：热门图集最多返回4个，热门新闻最多返回10条（在mrobot控制，后期变动直接改mrobot接口即可）。客户端拿到数据直接显示
缓存时间
无
提交方式
GET
是否登录
否
数据来源
无
参数
无
返回
{
"hot_keyword": "魅族",
"hot_photo": [
{
"title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测", //标题
"image": "http: //img0.xxx/123.jpg",
"to-uri": "pconlinebrowser://album-photo/14686"
},
{
"title": "关公战秦琼!戴尔XPS 13与苹果新本PK评测",
"image": "http://img0.xxx/123.jpg",
"to-uri": "pconlinebrowser://album-photo/14686"
}
],
"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"
}
]
}
返回参数说明
| 参数名 | 参数含义 |
|---|---|
| hot_keyword | 搜索框关键字（只会返回一个) |
| hot_photo | 热门图集(以下三个参数是hot_photo段) |
| title | 标题 |
| to-uri | 图集跳转协议 |
| image | 图片URL |
| hot_news | 热门新闻(以下三个参数是hot_news段) |
| id | 新闻ID |
| cmtCount | 评论数 |
| image | 图片URL |
| pubDate | 发表时间 |
| title | 新闻标题 |
| url | 文章跳转协议 |
1.7资讯文章终端页优化
mrobot接口：
iOS： http://mrobot.pconline.com.cn/configs/pconline_ios_auto_update.json
Android： http://mrobot.pconline.com.cn/configs/pconline_android_auto_update.json
说明
目前的资讯文章终端页太大，拆分成css、js和html主体两个部分，其中css、js放客户端本地，html主体由mrobot接口给出；客户端需支持在线更新css、js功能
缓存时间
无
提交方式
GET
是否登录
否
数据来源
无
参数
| 参数名 | 类型 | 必须 | 说明 |
|---|---|---|---|
| platform | string | 是 | 平台标识。android平台，platform=android；ios平台，platform=ios |
| v | string | 是 | 版本号当前版本为4300 |
| resVer | string | 是 | 资源包版本号。resVer=4301，此版本号由app版本号和资源包迭代版本构成，如资源包第一版，resVer=4301；资源包第二版，resVer=4302，如此类推 |
返回
{
date: "2015-09-21 17:00:00",
patch-uri: "",
patch-md5: "",
resVer: 21000,
description: ""
}
返回参数说明
| 参数名 | 参数含义 |
|---|---|
| date | 更新时间 |
| patch-uri | 下载地址 |
| patch-md5 | md5校验串 |
| resVer | 版本号 |
| description | 描述 |
