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显示
4.0.0版本在这个接口新增了3个广告位,首页图文列表广告,第5(test.adtest.test1.)、10(test.adtest.test2.)、20(test.adtest.test3.)位,括号内为测试广告标识
mrobot接口:
ios:http://mrobot.pconline.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20
安卓:http://mrobot.pconline.com.cn/v2/cms/channels/999?pageNo=1&pageSize=20
后端接口:
(已上线)ios:http://www.pconline.com.cn/app/21json/
(已上线)安卓:http://www.pconline.com.cn/android/21json/
(已上线)广告:http://ivy.pconline.com.cn/adpuba/show?id={广告标识}
HTTP请求方式:get
是否需要登录:否
返回格式:json
是否缓存:有
缓存时间:5分钟
请求参数:
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": 文章详情地址,
"readonly":true,
"informationType": 资讯类型
}
],
"focus": [ //备注:此处无专题类型
{
"counter": "",
"id": 文章id,
"image": 文章图片地址,,
"pubDate": 发布时间,
"title": 标题,
"url": 文章详情地址,
"readonly":true,
"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",
"informationType": 7 //广告
}
],
...
"total": 文章总数量
}
2.2 首页 - 评论列表
备注:获取文章评论,本次修改,新增用户头像字段face,评论来源字段from,name字段取原始接口返回的用户昵称(开发完成)
mrobot接口URL:http://mrobot.pconline.com.cn/v3/cmt/new_topics/13307019?articleId=6111016&pageSize=20&pageNo=1&reverse=0
后端接口URL:
(已上线)所有评论:http://cmt.pconline.com.cn/action/comment/list_new_json.jsp?tId=13307019&arch=0&reverse=0&pageSize=20
(已上线)最热评论:http://cmt.pconline.com.cn/intf/tophot.jsp?tid=13307019
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
topicId:主题ID
articleId:文章ID
reverse:排序方式:0 倒序; 1 正序
pageNo:页码
pageSize:每页行数
返回数据:
{
"comments": [
{
"1": {
"client": "2",
"content": "一加总说自己不是oppo的儿子,拿你爹的衣服改改你确实也能穿,全是靠oppo的支持还跑出来谈独立。",
"face": "http://i7.3conline.com/images/upload/upc/face/81/37/03/3/8137033_50x50",
"floor": "46",
"from": "来自Android客户端网友",
"id": "39202998",
"name": "guohuang16888",
"time": "2015-02-07 08:54:56",
"userId": "8137033"
},
"2": {
"client": "6",
"content": "其实吧,他能提供优秀的硬件与服务对我们消费者来说就够了,一加是谁的儿子关我们体验什么事",
"face": "http://i7.3conline.com/images/upload/upc/face/0/0_50x50",
"floor": "47",
"from": "来自PConline触屏版",
"id": "39203202",
"name": "广东省广州市网友",
"time": "2015-02-07 10:21:50",
"userId": "0"
},
......
"current": "6",
"expand": false,
"support": "1"
},
......
],
"docUrl": "http://mrobot.pconline.com.cn/v3/cms/articles/6111016",
"hot-comments": [
{
"1": {
"client": "2",
"content": "一个rom就叫OS,真不要脸",
"face": "http://i7.3conline.com/images/upload/upc/face/26/41/08/09/26410809_50x50",
"floor": "6",
"from": "来自Android客户端网友",
"id": "39200658",
"name": "钟原TNT",
"time": "2015-02-06 15:29:06",
"userId": "26410809"
},
"current": "1",
"expand": false,
"support": "48"
},
......
],
"pageCount": 4,
"pageNo": 1,
"total": 75
}
2.3 首页 - 文章顶踩、取消顶踩新接口
备注:该接口已经合并顶踩和取消顶踩功能(如果用户登录,则传common_session_id,如果用户没登录,则不传);直接使用后端接口;HTTP请求方式为POST(参考bip接口文档)
mrobot url:暂无
后端url:
(已上线)http://bip.pconline.com.cn/intf/article.jsp?act=delOrAddArtAgree&siteId=1&articleId=5105797&isAgree=1
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act:请求动作,delOrAddArtAgree为顶、踩文章和取消顶、踩文章动作
siteId:主网站id,电脑网为1
articleId:文章id
isAgree:1表示“顶/取消顶”;2表示“踩/取消踩”
返回结果:
{"code":0,"message":"用户赞、踩文章成功"}
{"code":-1,"message":"文章不存在"}
如果isAgree为空
{"code":-1,"message":"缺少isAgree参数"}
如果用户未登录:
{"code":1,"message":"该IP用户取消赞成功"}
{"code":2,"message":"该IP用户取消踩成功"}
{"code":3,"message":"该文章已被该IP用户赞过"}
{"code":4,"message":"该文章已被该IP用户踩过"}
如果用户已经登录:
{"code":1,"message":"该用户取消赞成功"}
{"code":2,"message":"该用户取消踩成功"}
{"code":3,"message":"该文章已被该用户赞过"}
{"code":4,"message":"该文章已被该用户踩过"}
结果说明:
调用该接口进行赞和踩操作,对于未赞,踩的文章进行执行赞,踩,对于已被赞,踩的文章进行取消赞,取消踩,对于已赞的文章不能进行踩/取消踩操作,对于已踩的文章不能进行赞/取消赞操作
2.4 图赏 - 推荐图集
备注:滚动到图集最后一张图后显示推荐图集,mrobot接口最多返回40条数据(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v2/photo/recommendAlbums
后端接口:
(已上线)http://www.pconline.com.cn/app/nq/1501/intf7381.js
HTTP请求方式:get
是否需要登录:否
返回格式:json
是否缓存:是
缓存时间:15分钟
请求参数:无
返回数据:
[
{
"id": 130583,//图集id
"image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图,尺寸待定
"photoCount": 10,//图片数
"title": "图集标题"
},
{
"id": 130583,//图集id
"image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图,尺寸待定
"photoCount": 10,//图片数
"title": "图集标题"
},
{
"id": 130583,//图集id
"image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图,尺寸待定
"photoCount": 10,//图片数
"title": "图集标题"
}
]
2.5 个人中心 - 用户信息
备注:个人中心,登录之后的用户信息;该版本新增用户好友数和粉丝数字段(开发完成)
mrobot接口URL:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo
后台接口:
获取用户信息:(已上线)http://itbbs.pconline.com.cn/action/user/user_setting_json.jsp
//用户未访问过电脑网论坛时,在电脑网论坛中还没有创建该用户的信息,故使用上面的接口不能获取到该用户的信息,此时改由下面的接口获取
(已上线)http://my.pconline.com.cn/intf/getIdByName.jsp?act=getShowNameById&accountId={用户id}
获取好友数:(已上线)http://bip.pconline.com.cn/intf/focus.jsp?act=getFocusNum&accountId={用户id}
获取关注数:(已上线)http://bip.pconline.com.cn/intf/focus.jsp?act=getFocusByNum&accountId={用户id}
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
uid:用户id,可选参数,规则是:如果传了uid,则返回的数据是该uid对应的用户的数据;如果没有传uid,则返回的是当前登录用户的数据;如果没有传uid,也没有登录,则返回0
返回数据:
{
"common_session_id": "9C40C3D0F2AC1E58F53AA7E7453DD94FAEF09FDB3AE4FD94",//当前用户的common_session_id,不管是否传了uid参数
"fans": 0,
"friends": 1,
"image": "http://i1.3conline.com/images/upload/upc/face/32/87/81/25/32878125_50x50",
"level": "太平洋舰队新兵",
"name": "czy3607",
"nickname": "czy3607",
"userId": 32878125
}
2.6 个人中心 - 获取粉丝、关注列表
备注:返回包括粉丝、关注列表
mrobot接口:无
后端接口URL:
(已上线)http://my.pconline.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID,如果没有改参数的话则返回当前用户的好友列表
act:findFocus为关注,findFocusBy为粉丝
pageNo:页码
pageSize:页长度
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
返回参数:
{
"total":18,
"pageCount":2,
"pageNo":1,
"pageSize":20,
"resultList":[
{
"accountId":用户ID
"focusNum":关注好友数
"fanNum":粉丝数
"nickName":用户昵称
"image":头像
}
]
}
2.7 个人中心 - 收到的私信列表、发出的私信列表
备注:收到的私信列表、发出的私信列表(开发完成)
mrobot接口URL:http://mrobot.pconline.com.cn/v3/itbbs/getMessageList?type=1&pageNo=1&pageSize=20
后端接口URL:
(已上线)发出的私信:http://bip.pconline.com.cn/intf/message.jsp?act=findOut&status=-1&pageNo=1&pageSize=20
(已上线)收到的私信:http://bip.pconline.com.cn/intf/message.jsp?act=find&status=-1&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
type:私信类型(1 收到的私信; 0 发出的私信)
pageNo:页码
pageSize:一页条数,默认20
返回参数:
收到的私信:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
accountId: 用户ID
senderId: 发送者ID
senderNickname:发送者昵称
senderFace:发送者头像
replyId: 回复ID
status: 阅读状态
showStatus: 显示状态
}
}
发出的私信:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
accountId: 用户ID
receiverId: 接收者ID
receiverNickname:接收者昵称
receiverFace:接收者头像
receiverIds: 接收者ID,可能为多个,是字符串
}
}
2.8 个人中心 - 发私信、回复私信接口
备注:发私信、回复私信接口
提示信息说明:
发送成功(code=0)后的提示:"发送成功"
发送失败(code!=0)的提示:分2种,匹配message字段;
当message字段为"请先绑定邮箱"时,提示"发送失败,请到网站个人中心绑定电子邮箱"
当message字段为其他内容时,提示"信息错误,发送失败!"
mrobot接口:无
后端接口URL:
(已上线)http://bip.pconline.com.cn/intf/message.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
必填参数:
act:create
content:私信内容
accountId: 接收私信者ID(以数组的形式接收,即&accountId=123&accountId=456),最多5个用户,白名单才能发送最多50个用户
非必填参数:
replyId:回复的私信ID
captcha:验证码,汽车网例外,凡是以bip.pcauto.com.cn/调用的不检查验证码
callback :支持回调函数,=windowname时表示以windowname形式返回
windowname :1或true 以windowname形式返回,不传或0或false以json格式返回
(说明:发送限制)
1.post
2.验证码
3.黑名单
4.邮箱绑定,该限制仅限於2012-01-01起注册的用户
5.发送频率 50次/ID/24H
6.白名单最多一次发送50个用户,非白名单则每次只能发一个
7.添加关键词库过滤
返回参数:
失败:{"code":-1,"message":"验证码不正确"}
{"code":-1,"message":"非法请求"}
{"code":-1,"message":"操作数据失败"}
{"code":-1,"message":"请先绑定邮箱"}
{"code":-1,"messgae":"最多只能同时向50个用户发送短消息"}
{"code":-1,"messgae":"您还没有登录,请先登录"}
{"code":-1,"messgae":"缺少发送者Id"}
{"code":-1,"messgae":"缺少内容"}
{"code":-2,"message":"缺少参数"}senderId在黑名单内
{"code":-1,"messgae":"短信内容包含关键字"}
{"code":-3,"message":"缺少参数"}senderId不存在
{"code":-100,"messgae":"接口访问频繁,请休息一会再试"}
{"code":2,"messgae":"对方在你的黑名单内:"}
成功:{"code":0}
2.9 个人中心 - 修改昵称
备注:修改昵称
mrobot接口:无
后端接口URL:
(已上线)http://my.pconline.com.cn/intf/syncNickName.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
req_enc:UTF-8
resp_enc:UTF-8
nickName:昵称
act:save
返回参数:
{"code":0}表示成功, {"code":非0,"message":"提示"}
2.10 个人中心 - 修改头像
备注:修改头像
mrobot接口:无
后端接口URL:
(已上线)http://upc.pconline.com.cn/upload_head.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:禁用缓存
缓存时间:无
请求参数:
二进制图片数据
返回参数:
成功:{retCode: 0} 失败:{retCode: xxx}
2.11 个人中心 - 关注、取消关注
备注:关注、取消关注
mrobot接口:无
后端接口URL:
(已上线)http://m.pconline.com.cn/bip/intf/focus.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=add|delete(add:关注,delete:取消关注)
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
{"code":0}成功
2.12 个人中心 - 判断与某用户的关系(关注与非关注)
备注:判断与某用户的关系
mrobot接口:无
后端接口URL:
(已上线)http://m.pconline.com.cn/bip/intf/focus.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=isHisFocus
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
0:没关注,1:关注,2:被关注,3:相互关注
2.13 个人中心 - 他人主页
备注:获取他人最新动态接口(开发完成)
mrobot接口请求URL:http://mrobot.pconline.com.cn/v3/itbbs/newsfeed?accountId=493681&pageNo=1&pageSize=10
后端接口URL:
(已上线)http://bip.pconline.com.cn/intf/source/newsfeed.jsp?typeIds=1001,1002,1003,1025,1026&act=findMyNewsfeed&accountId=20963251&siteId=1&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
accountId: 用户Id
pageNo: 页码
pageSize: 每页条数
备注:获取他人的评论,只出普通cms文章,直播,图集数据,过滤掉了聚超值,专题,下载,旧文章的数据(开发完成)
mrobot接口请求URL:http://mrobot.pconline.com.cn/v3/cmt/commentList?userId=32878125&pageNo=1&pageSize=10
后端接口URL:
(已上线)http://cmt.pconline.com.cn/intf/uc_user_cmt_nobest.jsp?userId=32878125&pageNo=1&pageSize=10&refTimes=0&noUbb=true&webSite=pconline
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
userId: 用户Id
pageNo: 页码
pageSize: 每页条数
2.14 个人中心 - 最新消息数
备注:私信消息数取messageCount字段(用原接口,并没有做任何修改)
mrobot接口URL:http://mrobot.pconline.com.cn/v3/itbbs/getNewMsgCount?accountId=31356890
后端接口URL:
(已上线)未读消息数接口:http://bip.pconline.com.cn/intf/message.jsp?act=getNumToJson&siteId=1&status=0
(已上线)未读系统消息数接口:http://bip.pconline.com.cn/intf/sysnotice.jsp?act=getNum&siteId=1&typeIds=4&accountId=31356890
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID
返回数据:
{
"articleCmtCount": 0,
"carReplyCount": 0,
"commentReplyCount": 0,
"fansCount": 0,
"forumReplyCount": 0,
"messageCount": 1, //此字段就是当前用户的未读私信数
"sysMsgCount": 0,
"systemNoticeCount": 0
}
2.15 个人中心 - 推广位列表
备注:返回推广位列表;uri参数部分需要按百分号转义(用原接口,并没有做任何修改)
mrobot接口URL:http://mrobot.pconline.com.cn/v2/cms/proxy?uri=http://app.pconline.com.cn/appnews/tghd/1403/intf4501.js
后端接口URL:无
特别注意:试用中心的推广,链接后面一定要带fromapp参数,才能解决同步登录问题
例如:http://g.pconline.com.cn/try/act_261.html?fromapp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
uri:被代理的原始接口
返回结果:
{
data:[
{
"tag": "论坛",
"title": "元旦刮卡抽399元智能水杯",
"to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
},
{
"tag": "直播",
"title": "元旦刮卡抽399元智能水杯",
"to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
},
{
"tag": "试用",
"title": "元旦刮卡抽399元智能水杯",
"to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1"
}
],
"baidu": [ //渠道编号(android专用,针对某些特殊渠道进行活动推广)
{
"title": "《成长印记》有奖互动活动",
"to-uri": "pconlinebrowser://bbs-topic/52042091",
"tag": "活动"
}
]
}
2.16 搜索 - 综合搜索
备注:返回结果包括相关产品、相关文章、相关帖子;具体规则参考web版综合搜索(开发完成)
返回结果说明:
相关产品:有则返回,没有则为空,服务器可先过滤,最多返回1条数据给客户端;
相关文章:按照目前的web规则,是搜索评测的相关文章,具体规则可以问问快搜接口的同事;返回数据,有则返回,没有则为空,服务器可先过滤,最多返回3条数据给客户端;
相关帖子:处理方式同文章;服务器可先过滤,最多返回3条数据给客户端。
mrobot接口URL:http://mrobot.pconline.com.cn/v3/compositeSearch?q=华为
后端接口URL:
(已上线)http://ks.pconline.com.cn/app/composite.shtml?q=%E5%8D%8E%E4%B8%BA
HTTP请求方式:GET
是否需要登录:否
返回格式:JSON
缓存方式:无
缓存时间:无
请求参数:
q:搜索的关键词
返回结果:
{
"articleList": [
{
"id": "5961196",
"pubDate": "2015-01-05",
"summary": "在信息互联时代,人们获取资讯和娱乐方式发生了天翻地覆的变化,智能手机机逐渐替代电视电脑,成为日常社交娱乐的主要平台,而平台的变迁并没有改变人们对宽广视野和畅爽体验的渴望,这就对智能手机的屏幕尺寸提出了高要求。最近,华为继年度人气产品Mate7之后,又在跨年之际震撼推出一款6英寸巨屏4G手机-华为GX1,带领千元级智能手机迈进巨屏时代。GX1聚焦千元市场,定价1590元,除具备6英寸巨屏之外,还拥有80.5%超高屏占比、精致时尚外观和3500毫安时的超强续航能力,具有超高性价比。",
"title": "6英寸大屏电信4G双卡手机 华为GX1评测",
"url": "http://mobile.pconline.com.cn/596/5961196.html"
},
{
"id": "5910857",
"pubDate": "2014-12-23",
"summary": "华为G7的综合性能颇为不错,拥有高通骁龙410 64位四核处理器,配以2GB+16GB的内存组合,属于中端智能手机水平,在日常运行还是应用娱乐方面都会有一个比较不错的体验。而在这篇长测文章中,将大家体验一下华为G7的游戏方面的性能表现。",
"title": "流畅性&兼容性不错 华为G7游戏性能体验",
"url": "http://mobile.pconline.com.cn/591/5910857.html"
},
{
"id": "5777740",
"pubDate": "2014-12-21",
"summary": "G7是近段时间华为较为热门的中端机型之一,其拥有超薄的机身设计,配以金属材质给人高档的感觉,而配合最新升级的EMUI 3.0系统,用户体验更上一层楼。除了上面说的特点外,经过这几天以来的试用,笔者对G7的拍摄性能也有不少惊喜,下面让我们来看看G7的拍摄样张。",
"title": "弱光出色综合表现优秀 华为G7拍摄体验",
"url": "http://mobile.pconline.com.cn/577/5777740.html"
}
],
"productList": [
{
"id": "559363",
"pic": "http://img.pconline.com.cn/images/product/5593/559363/z_sn7.jpg",
"price": 798,
"summary": "2G/3G网络:GSM,TD-SCDMA(移动3G),双卡双待 | 主屏尺寸:5.0英寸 | 屏幕分辨率:1280×720像素(720P) | 系统:Android 4.2 | 电池容量:可更换,2300mAH | CPU:MT6582 1.3GHz(4核)",
"title": "华为 荣耀3C移动3G版/1GB RAM"
}
],
"topicList": [
{
"createAt": 1421857016000,
"replycount": "2",
"summary": "全新华为移动版4x高配套装,等钱用按发票出!有意讲电13802780039,发票价应该1090左右!有耳机皮套!!!",
"title": "发票价出全新华为移动板高配4x",
"topicId": "52027455"
},
{
"createAt": 1421902291000,
"replycount": "0",
"summary": "这次玩“虚”的,华为荣耀6Plus使用评测 如今手机拍摄质量越来越受重视,甚至大有取代卡片式数码相机的趋势,所以现在各个手机厂家也是加大了研发力度,旨在提高拍摄质量。华为荣耀6Plus是目前比较吸引众人目光的一款手机,除了本身较为强悍的硬件配置和相对实惠的价位外,颠覆性后置平行双镜头设计是它最大的亮点。 表面上看去,貌似荣耀6Plus的背壳跟荣耀6没有什么区别,但实际上荣耀6Plus的后壳却是大有文章的。它采用了堪比军用头盔防弹级硬度的玻璃纤维当做基底,再历经六层复合工艺雕琢而成,不仅仅只是美观,而重要是结实耐用抗划痕,虽然也容易留下指纹,只不过白颜色看不大出来。 就外观而言,荣耀6Plus和荣耀6大同小异,只不过荣耀6Plus采用的是5.5英寸的屏幕,78.2%的屏占比更高些。而不同的地方是荣耀6的塑料边框,到了荣耀6Plus则采用了金属边框。这金属边框采用的是顶尖钻石刀高光切削工艺,更亮泽顺滑的边框不但结实耐用,而且更加有质感,也提升了机身的档次。 荣耀6前置的摄像头采用的是主流的500万像素摄像头,而荣耀6Plus则采用了索尼800万像素BSI传感器。该镜头的传感器达到了1.4um大像素尺寸、5P非球面镜片,而且清晰取景范围可达80度,自拍的效果相对荣耀6而言也有一定的提升。 荣耀6Plus的接口和按键的布局基本上跟荣耀6是一致的,而且同样也都具备了红外遥控功能。在手机内置了独立红外遥控芯片,并预置全球顶级供应商的红外码库,家里的电视机、机顶盒、空调等家电,基本上都可以使用荣耀6Plus遥控,真正体验了智能化。 荣耀6Plus背面的镜头、闪光灯和扬声器的位置都和荣耀6一样,而最明显的差异就是荣耀6Plus多了一只“眼睛”。在业界,后置双镜头并非荣耀6Plus首创,可能大家比较熟悉的HTC M8也正常采用后置双镜头设计。不过HTC M8的后置双镜头其中一个镜头是用来记录拍照时空间信息和景深,这跟现在不少手机具备的“先拍摄后对焦”功能有异曲同工之妙。HTC M8的后置双镜头是纵向设计,而荣耀6Plus的双摄像头则是并行设计,而且并行设计的好处就是实现双镜头并行双工曝光,使得HDR拍照速度提升几乎一倍,而且在逆光等光线高反差环境中,双镜头HDR能够有效降低手机抖动或拍摄对象运动带来的不良影响,大幅消除鬼影,成像更清晰稳定。此外,双镜头HDR能够有效增加照片的宽容度,极大地提升高光区域和暗部区域的细节呈现能力。 荣耀6Plus后置的这两颗摄像头的像素分别为800万像素,但是成像分辨率却是可达1300万像素,而且搭载数十项专利的3IE算法引擎系统,具备最快0.1秒快速对焦和记录全景深信息的能力。因为荣耀6Plus在拍摄时是双镜头同时捕捉画面,所以进光量和感光面积是单镜头的两倍,加上它的有效像素尺寸提升到1.98um,感光度也增加不少,让在弱光环境下拍摄的成像更清晰透亮。为了让双镜头更加稳固耐用,荣耀6Plus选用了高强度的锌合金支架,并采用坚固的玻璃纤维作为后壳基底,通过点胶方案从内到外固化上摄像头位置。 荣耀6Plus的拍照设置界面跟荣耀6大致一样,但拍照功能有所强化。用户们喜闻乐见的有声拍照、触摸拍照、笑脸抓拍都具备了,而且目标跟踪有利于对拍摄主体更好地对焦,熄灭快拍更适合抓拍。此外,图像的饱和度、对比度和亮度都可以多级调整。 对于喜欢摄影的朋友来说,要营造出色的虚化背景是离不开大光圈镜头的,荣耀6Plus后置镜头的光圈就达到了F2,也称得上是大光圈,微距拍摄时亦是可以营造出较为完美的背景虚化。但仅仅F2的光圈就够了吗?荣耀6Plus这次也算是“革命”一回了,它根据3IE算法引擎系统,提供了F0.95到F16光圈的调整,让拍照时选择的焦点区保持清晰画面,而焦点之外的画面则通过软件算法进行虚化,从而营造出大光圈特有的虚化效果。 使用大光圈拍摄的照片,都可以再次重新调整光圈大小和对焦点,配合70mm到无穷远的全景深信息,以获得不同背景虚化效果和不同对焦点的全新照片。就我个人的理解,大光圈可以解读为一种图片后期处理应用,无论选择哪个光圈值拍摄,都能同时获得一张全景深的清晰照片,然后再进行二次编辑。 直言不讳,这个大光圈效果还不能跟单反相机相提并论,只不过这创新的精神还是很值得肯定的,尤其是喜欢用手机近摄的朋友应该很喜欢这个功能。下面的图片采用大光圈模式默认的F4光圈拍摄,拍完之后再把光圈调到F0.95,背景虚化的效果差别还是挺明显的。 荣耀6Plus的实际拍摄效果又如何呢?我选择了同样是近期倍受关注的vivo X5max与之进行一番对比,分别从夜景、室内、室外、微距、逆光等多个场景拍摄,究竟它们是势均力敌,还是各有千秋?让我们一起来看看样片吧。 从夜景的样张来看,两款手机的成像效果还是比较令人满意的,噪点的控制都比较出色,画面整体比较纯净耐看。不过从夜景的细节来看,还是X5Max略胜一筹,我个人认为这个可能跟它的快门速度有关系,荣耀6Plus的快门速度不及X5Max,这样就容易造成在弱光环境下拍照因为手抖而画面模糊。如果论画面的亮度,则荣耀6Plus会更加优秀,加上更高的色彩对比度,画面看上去更有夜景的氛围感。 通过室内样片我们可以判断出两款手机拍照成像风格还是有所不同的,X5Max会偏冷色调,而荣耀6Plus则会偏暖色调。X5Max的色彩会更加地接近真实色彩,而荣耀6Plus的暖色调又会比较讨喜,喜欢哪种风格,见仁见智。 这种冷暖色调的区别,不仅仅表现在室内拍摄,户外拍摄的成像效果也是如此,而且比较明显。下面这组叶子照片,两种风格迥然不同,但相信大多数人会更喜欢荣耀6Plus偏暖成像这张吧,更有深冬红叶的感觉。不过也不否认在对一些冷色调色彩事物的拍摄时,X5Max又有自己的优势,比如蓝天、绿叶。 也许是得益于双镜头可以获得更多的进光量,在使用两款手机默认的自动模式拍摄之后,我发现无论是室内还是室外,荣耀6Plus的画面亮度都比X5Max来得高,尤其是在像阴天这种光线不是很强的环境下拍摄,效果就更加明显,逆光拍摄亦是如此,荣耀6Plus获得的暗部细节比X5Max要来得多。 两款手机更多的样张对比: 荣耀6Plus是华为公司在2014年底的收官之作,首先值得肯定的是它可以在硬件有不小升级的情况下,仍然保持1999元的价位。荣耀6Plus采用了3G的运行内存并搭配16G的机身内存,5.5英寸的1080P高清大屏幕和麒麟925八核心处理器也都比较给力。其次,后置平行双镜头的设计也却是令人耳目一新,而且大光圈的虚化效果也较为明显,尽管跟单反依然存有差距,但总算是赋予了手机拍摄更多的可能,也开创了业界先河。此外,荣耀6Plus还采用了3600毫安的大容量电池、支持双卡双待、支持4G网络等,也是颇有诚意的。",
"title": "这次玩“虚”的,华为荣耀6Plus使用评测",
"topicId": "52028193"
},
{
"createAt": 1421856080000,
"replycount": "10",
"summary": "白色的那个无线网关 不知道是什么型号!海外版~设置界面是英文,不能直接插卡用的,需要插USB 3G无线网卡使用!有WIFI功能! 黑色的那个是阉割版的B932 无WIFI功能 有一个LAN接口和一个语音电话接口 也是海外版~设置界面为英文! 两个打包100包邮全国",
"title": "出2个闲置的华为3G无线路由器",
"topicId": "52027425"
}
]
}
2.17 其他 - 广告
备注:广告接口,增加评论列表广告位(开发完成)
mrobot接口URL:http://mrobot.pconline.com.cn/v3/ad
后端接口URL:(此广告标识在mrobot后台配置,等正式标识确定后替换)
http://ivy.pconline.com.cn/adpuba/show?id=test.test_gg_.test14_gg_.
HTTP请求方式:GET
是否需要登录:false
返回格式:JSON
请求参数:无
返回结果:
{
"pc.khd.zx.btxfwz.": {
"ads": [
{
"cc-uri": "",
"cc3d-uri": "",
"text": "双4G台版iPhone6 仅售4699",
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=342222&id=pc.khd.zx.btxfwz.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=342222&id=pc.khd.zx.btxfwz.&media=js",
"vc3d-uri": ""
}
]
}
"pc.khd.zx.plytgw.": { //评论列表广告位
"ads": [
{
"cc-uri": "",
"cc3d-uri": "",
"text": "双4G台版iPhone6 仅售4699",
"img": "图片地址"
"to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=342222&id=pc.khd.zx.btxfwz.",
"vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=342222&id=pc.khd.zx.btxfwz.&media=js",
"vc3d-uri": ""
}
]
}
}
2.18 其他 - 微信登录相关接口
这部分相关接口,不经过mrobot,如需测试的话,请客户端同事补充
备注:微信登录相关接口(可能不至一个接口,具体需要与passport同事[丁健勇]联系)
具体接口说明请补充
3.协议说明
3.1 文章页跳转评论页协议
协议名:pconlinebrowser://comment/{评论id}
参数:评论id:该文章的评论id,无法获取时,传-1;另外,客户端目前不需要评论id
备注:此协议在4.0.0版本中的有效范围:文章页
3.2 跳转至他人主页协议
协议名:pconlinebrowser://user-center/{用户id}
参数:用户id:用户的通行证id,必填字段
备注:此协议在4.0.0版本中的有效范围:帖子页、他人主页中的动态页
3.3 他人主页跳转至帖子页协议
协议名:pconlinebrowser://bbs-topic/{帖子id}?from={最数码piebbs/非最数码itbbs}
参数:帖子id:当前帖子的id,必填字段,是否为最数码论坛frome=piebbs为最数码,from=itbbs为论坛 必填字段
备注:此协议在4.0.0版本中的有效范围:他人主页
3.4 他人主页跳转至论坛页协议
协议名:pconlinebrowser://bbs-topics/{论坛id}?from={最数码piebbs/非最数码itbbs}
参数:论坛id:当前论坛的id,必填字段,是否为最数码论坛frome=piebbs为最数码,from=itbbs为论坛 必填字段
备注:此协议在4.0.0版本中的有效范围:他人主页
3.5 他人主页跳转至图库终端页协议
协议名:pconlinebrowser://album-photo/{图集id}
参数:图集id:当前图集的id,必填字段
备注:此协议在4.0.0版本中的有效范围:他人主页
3.6 他人主页跳转至文章页协议
协议名:(非文章直播页)pconlinebrowser://information-article/{文章id}
(文章直播页)pconlinebrowser://information-article/{文章id}?template=live
参数:文章id:当前评论的id,必填字段
备注:此协议在4.0.0版本中的有效范围:他人主页
3.7 产品详情页跳转至对比页协议
协议名:pconlinebrowser://product-compare-param/{产品id}
参数:产品id:当前产品的id,必填字段
备注:此协议在4.0.0版本中的有效范围:产品详情概述页
3.8 产品详情页(点评)跳转至点评详情页协议
协议名:pconlinebrowser://product-detail-commentDetail/{点评id}?productId={产品id}
参数:点评id:当前点评的id,productId:当前产品id 必填字段
备注:此协议在4.0.0版本中的有效范围:产品详情页(点评)
3.9 点评详情页查看大图协议
协议名:pcaction://big-photo?data={所有图片数据json格式,包括total图片总数,photos图片url数组,currentIndex当前图为当前图集的默认索引(如果当前点击图集的封面为固定图集的第一张图则该字段可以忽略,即默认都是第一张图作为图集封面)}
参数:所有图片数据:当前点击的图集(包括图片总数,photos图片url数组),currentIndex当前图为当前图集的默认索引(如果当前点击图集的封面为固定图集的第一张图则该字段可以忽略,即默认都是第一张图作为图集封面),必填字段
备注:此协议在4.0.0版本中的有效范围:点评详情页
4.产品库新增或修改页面
4.1 产品库点评页
备注:4.0.0版本新开发的产品库点评页,用于4.0.0和以后的版本,旧版本app沿用之前旧版的点评页(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v3/product/commentList/565502?pageNo=1&pageSize=5&appVersion=4.0.0
后端url:
(已上线)http://pdcmt.pconline.com.cn/comments/product_cmt_json_4_wap.jsp?pid=565502&pageNo=1&pageSize=5&&order=2
HTTP请求方式:get
是否需要登录:否
返回格式:HTML页面
是否缓存:是
缓存时间:15分钟
请求参数:
产品id
pageNo 页码
pageSize 每页数量(产品要求为5)
appVersion app版本号(备用)
4.2 产品库点评详情页
备注:4.0.0版本新开发的产品库点评详情页,用于4.0.0和以后的版本,旧版本app沿用之前旧版的点评页(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v3/product/commentDetail/565502?cmtid=1014215&pageSize=10&pageNo=1&appVersion=4.0.0
后端url:
(已上线)http://pdcmt.pconline.com.cn/comments/cmt_json_4_wap.jsp?cmtid=1014215&pid=565502&pageSize=10&pageNo=1
HTTP请求方式:get
是否需要登录:否
返回格式:HTML页面
是否缓存:是
缓存时间:15分钟
请求参数:
产品id
cmtid 点评id
pageNo 页码
pageSize 每页数量(产品要求为10)
appVersion app版本号(备用)
4.3 产品库概述页
备注:4.0.0版本改版的产品库概述页,4.0.0及以后版本,页面上有对比按钮,旧版本没有,另外,页面上还新增了一个元数据pubUrl,用于客户端分享功能使用(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v3/product/summary/535555?appVersion=4.0.0
后端接口URL:
(已上线)产品基本信息:http://pdlib.pconline.com.cn/product/intel/base_info_json.jsp?productId=535555
(测试接口)产品参数:http://v28.pconline.com.cn/intf/productSummaryParam.jsp?productId=535555
(已上线)点评:http://pdcmt.pconline.com.cn/comments/product_cmt_json_4_wap.jsp?order=2&pageNo=1&pageSize=5&pid=535555
(已上线)产品相关资讯:http://pdlib.pconline.com.cn/product/service2011/article_json.jsp?pageNo=1&pageSize=20&hasHangQing=0&productId=535555
(已上线)图片数量:http://product.pconline.com.cn/3g/service/page_pic.jsp?pageSize=1&pId=535555
(已上线)概述页报价栏:http://priceparity.pconline.com.cn/intf/price_list_for_app.jsp?productId=535555&style=1&max=3&cnt=1
HTTP请求方式:get
是否需要登录:否
返回格式:HTML页面
是否缓存:是
缓存时间:1周
请求参数:
产品id
appVersion app版本号
4.3 产品库报价页
备注:4.0.0版本改版的产品库报价页,采用新样式,同一电商的报价放在一起,点击打开或者收起,电商内的报价从低到高排序(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v3/product/comparePrice/565502?appVersion=4.0.0
后端接口URL:
(已上线)http://priceparity.pconline.com.cn/intf/shop_list_json.jsp?pid=565502
HTTP请求方式:get
是否需要登录:否
返回格式:HTML页面
是否缓存:是
缓存时间:1天
请求参数:
产品id
appVersion app版本号(备用)
5.文章页修改
备注:4.0.0版本改版文章页,采用新样式,加入热门评论和文章底部广告两个模块,并且(产品卡、相关文章、热门评论、广告)这4个部分放在文章最后一页,加入一个新参数appVersion,4.0.0及其以后版本,可以点击评论跳转到评论页,旧版本不行(开发完成)
mrobot请求URL:http://mrobot.pconline.com.cn/v3/cms/articles/5576017?articleTemplate=3.6.0&size=18&picRule=2&app=pconlinebrowser&template=(null)&channelId=5&serialId=0&appVersion=4.0.0
后端接口URL:
(已上线)cms文章:http://192.168.10.67:8002/interface/pconline/mrobot_articles_v3.jsp?id=5576017
HTTP请求方式:get
是否需要登录:否
返回格式:HTML页面
是否缓存:是
缓存时间:1个小时
请求参数:
appVersion: 新增参数,标识app版本号