wiki:pcgamesv2.0.0/interface

Version 10 (modified by caozhaoyuan, 11 years ago) (diff)

--

1.基本约定

代理环境说明:
192.168.10.198 端口为 1080 连的是v80的测试环境(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)
接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)
接口URL: 接口URL

参数名类型必须说明

说明文档参数:添加某特定参数可以直接看接口文档
是否需要登录:是|否
返回格式:json|xml|ssi,
缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存()
缓存时间:缓存时间
返回结果:结果可能情况

2.接口列表

2.1 资讯模块

2.1.1 资讯列表


原mrobot接口: http://mrobot.pcgames.com.cn/v3/cms/channels/1
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:分页返回数据,每个资讯新增informationType字段标明类型;tags字段如果包含视频则显示“视频标签”
请求参数:
pageNo=页码
pageSize=一页条数,默认20,最大500
备注:

informationType = 0, 其他
informationType = 1,
文章
informationType = 2, 帖子
informationType = 3,
图集
informationType = 4, 直播类型
informationType = 5,
专题类型
informationType = 6, 聚超值类型
informationType = 7,
推广类型(广告)
informationType = 8, 视频(新增字段,mrobot根据接口返回的tags字段是否包含"视频"关键字来判断该类型)


返回数据结构:

{
    "articleList": [                   //文章列表
        {
            "cmtCount": 0,             //文章评论数
            "id": "5268527",           //文章id
            "image": "http://img0.pcgames.com.cn/pcgames/1506/25/g_5268527_1435204419289.jpg",   //文章图片地址
            "preView": "USB充电线,3DS,周边",
            "pubDate": "2015-06-25",           //发布时间
            "summary": "コロンバスサークル推出的复古风格多插口USB充电线将在今年7月发售!此",
            "tags": "USB充电线,3DS,周边",                    //标签,视频需要根据该字段是否包含"视频"关系字来决定informationType的值
            "title": "FC手柄风格多插口USB充电线7月发售",     //标题
            "url": "http://3ds.pcgames.com.cn/526/5268527.html",
            "informationType": 8
        }
    ],
    "topArticle": [       //置顶文章列表
        {
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/sns/1506/23/c0/8778695_1435028691013_150x150.jpg",
            "isExtend": "0",
            "preView": "声优一直都是许多动画或是需要配音作品的一大灵魂,是幕后大功臣,以前声优似乎都不太露面的,但是现在因为一些见面会还有握手会等等的活动,让这些声优走出幕后,也在萤光幕前亮相!而在许多人心目中也就有了《最美声优》的存在",
            "pubDate": "2015-06-23",
            "seq": 1,    
            "title": "最美声优排行榜TOP10",
            "to-uri": "pcgamesbrowser://bbs-topic/2984841",
            "updateAt": 1434988800000,
            "informationType": 8
        }
    ],
    "focus": [    //焦点图
        {
            "id": "5149423",            //焦点图ID
            "image": "http://img0.pcgames.com.cn/pcgames/sy/review/1505/APP.jpg",   //焦点图片URL
            "pubDate": "2015-05-21",                                                //发布时间 
            "tags": "全民飞机大战,全民飞机大战双打模式,苹果游戏评测,安卓游戏评测",
            "title": "《全民飞机大战》评测:同屏双打并肩出机",
            "url": "http://sy.pcgames.com.cn/514/5149423.html"
        }
    ],
    "topFocus": [   //焦点图置顶
      {
            "id": "5149423",            //焦点图ID
            "image": "http://img0.pcgames.com.cn/pcgames/sy/review/1505/APP.jpg",   //焦点图片URL
            "pubDate": "2015-05-21",                                                //发布时间 
            "seq": 1,    
            "tags": "全民飞机大战,全民飞机大战双打模式,苹果游戏评测,安卓游戏评测",
            "title": "《全民飞机大战》评测:同屏双打并肩出机",
            "url": "http://sy.pcgames.com.cn/514/5149423.html"
        }
    ],
    "pageNo": 1,    //当前页数
    "pageSize": 20,  //一页条数,默认20,最大500
    "total": 200  //文章总数量  
}

2.1.2 文章终端页


原mrobot接口: http://mrobot.pcgames.com.cn/v3/cms/articles/4971942?size=18&picRule=1&template=(null)
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:参照1.基本约定
缓存时间:参照1.基本约定
说明:支持设置字体和读图模式
请求参数:

参数名类型必须说明

size=18 字体大小(16,18,20)
picRule=1
1无图,2大图,3小图
具体可参考电脑网

2.1.3 文章评论列表


原mrobot接口:  http://mrobot.pcgames.com.cn/v3/cmt/topics/13509342?reverse=0&support=1
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:返回数据改为json,分页返回数据,支持正倒序
请求参数:

参数名类型必须说明


返回数据结构:参考电脑网文章评论列表 http://mrobot.pconline.com.cn/v3/cmt/new_topics/13359138?pageNo=1&pageSize=20&reverse=0&articleId=6571490

2.2 论坛模块

2.2.1 帖子列表


原mrobot接口:  http://mrobot.pcgames.com.cn/proxy/bbs/forums/27485?filter=pick&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:分页返回数据,支持三种排序:最近回复/最近发表/精华帖
请求参数:

参数名类型必须说明


返回数据结构:

2.2.2 帖子终端页

[BR]]原mrobot接口:  http://mrobot.pcgames.com.cn/v2/bbs/topics/2970513?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:
说明:回帖加上回复楼层的功能,区分只看楼主和查看全部
请求参数:

参数名类型必须说明


返回数据结构:

2.3 搜索模块

2.3.1 资讯搜索

[BR]]原mrobot接口:  http://mrobot.pcgames.com.cn/v3/cms/search?q=iphone
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:根据关键字按时间返回资讯,分页
请求参数:

参数名类型必须说明


返回数据结构:

2.3.2 帖子搜索

[BR]]原mrobot接口:  http://mrobot.pcgames.com.cn/v3/bbs/search?q=ios&forumId=28222
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:根据关键字按时间返回帖子,分页
请求参数:

参数名类型必须说明


返回数据结构:参考电脑网帖子搜索: http://mrobot.pconline.com.cn/v3/itbbs/search?q=ios&pageNo=1&pageSize=20

2.4 直播模块

2.4.1 直播列表页

2.4.2 直播终端页