wiki:pconline_3.10.0/interface

Version 7 (modified by wuchangbo, 12 years ago) (diff)

--

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(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 专题列表 - JSON格式跟资讯的一样

备注:此接口返回专题列表
 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": 文章总数量	
}