[[TOC]] == 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 [=#point201 个人中心 - 系统消息列表] === {{{ 备注:此接口返回系统消息列表 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 [=#point202 个人中心 - 清零系统消息] === {{{ 备注:此接口清零系统消息(后端接口需要确认,目前使用Web版个人中心接口) mrobot接口:暂无 后端接口:http://my.pconline.com.cn/bip/intf/sysnotice.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数:请求参数为json {"act":"deleteAll","siteId":1} }}} === 3.1 [=#point301 资讯列表 - 增加专题ID(topicId)] === {{{ 备注:此接口返回资讯消息列表 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": 文章总数量 } }}} === 3.2 [=#point302 专题列表 - 新增接口] === {{{ 备注:此接口返回专题列表 mrobot接口:暂无 后端接口:http://mrobot.pconline.com.cn/v2/cms/topics/{专题ID}?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": 文章总数量 } }}}