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 个人中心 - 系统消息列表
备注:此接口返回系统消息列表
mrobot接口:暂无
后端接口:http://bip.pconline.com.cn/intf/sysnotice.jsp?act=find&groupType=0&common_session_id=C2BE11FFA56EBACBD70F9A0C5BF0F10CE1368EA71ABF0802&resp_enc=UTF-8&siteId=1&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=find
siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status=-1(-1为已读和未读,0表示未读,1表示已读)
typeIds=2004
groupType=消息分组,默认全部,开发人员提供
status=0是未读,1是已读,默认-1是全部
startDate=开始时间
endDate=结束时间
beforeDay=在某个时间前
pageNo=页码
pageSize=一页条数,默认20,最大500
noTemplate=true不需要模板,false需要模板,默认是false
返回参数:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
type: { //消息类型
name: 消息类型名称
id: 消息分类ID
description: 描述
siteId: 网站ID
templateId: 模板ID
groupType: 分组ID
}
content: 模板内容
createTime: 发送消息时间戳
status: 状态
accountId: 接收消息人
siteId: 网站ID
typeId: 分类ID
senderId: 发送者ID
groupSend: 是否群发
groupType: 消息分组
resultText: 操作结果
}
2.2 个人中心 - 清零系统消息
备注:此接口清零系统消息(后端接口需要确认,目前使用Web版个人中心接口)
mrobot接口:暂无
后端接口:http://my.pconline.com.cn/bip/intf/sysnotice.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:请求参数为json
{"act":"deleteAll","siteId":1}
3.1 资讯列表 - 增加专题ID
备注:此接口返回系统消息列表
mrobot接口:暂无
后端接口:http://mrobot.pconline.com.cn/v2/cms/channels/999?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": 文章详情地址,
"topicId":专题ID(可以为空)
}
],
"focus": [
{
"counter": "",
"id": 文章id,
"image": 文章图片地址,,
"pubDate": 发布时间,
"title": 标题,
"url": 文章详情地址,
"topicId":专题ID(可以为空)
}
],
...
"total": 文章总数量
}