[[TOC]]

== 1.基本约定 ==
代理环境说明： 
[[BR]]192.168.10.198 端口为 1080 连的是v80的测试环境（192.168.74.80） 
[[BR]]192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
[[BR]]接口通用参数
[[BR]]req_enc=utf-8(必须放url后面)
[[BR]]resp_enc=utf-8(必须放url后面)
[[BR]]common_session_id=xxxx(以cookies中的优先)
[[BR]]接口URL: 接口URL
||参数名||类型||必须||说明||
说明文档参数：添加某特定参数可以直接看接口文档
[[BR]]是否需要登录：是|否
[[BR]]返回格式：json|xml|ssi,
[[BR]]缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
[[BR]]缓存时间：缓存时间
[[BR]]返回结果：结果可能情况



== 2.接口列表 ==
=== 2.1 [=#point2.1 资讯模块] ===
==== 2.1.1 [=#point2.1.1 资讯列表] ====
[[BR]]原mrobot接口:http://mrobot.pcgames.com.cn/v3/cms/channels/1
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:分页返回数据，每个资讯新增informationType字段标明类型；tags字段如果包含视频则显示“视频标签”
[[BR]]请求参数:[[BR]]
pageNo=页码[[BR]]
pageSize=一页条数，默认20，最大500[[BR]]
备注：[[BR]]
 informationType = 0,     //其他[[BR]]
 informationType = 1,     //文章[[BR]]
 informationType = 2,     //帖子[[BR]]
 informationType = 3,     //图集[[BR]]
 informationType = 4,     //直播类型[[BR]]
 informationType = 5,     //专题类型[[BR]]
 informationType = 6,     //聚超值类型[[BR]]
 informationType = 7，    //推广类型(广告)[[BR]]
 informationType = 8，    //视频(新增字段，mrobot根据接口返回的tags字段是否包含"视频"关键字来判断该类型)  [[BR]]

[[BR]]返回数据结构:

{{{

{
    "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 [=#point2.1.2 文章终端页] ====
[[BR]]原mrobot接口:http://mrobot.pcgames.com.cn/v3/cms/articles/4971942?size=18&picRule=1&template=(null)
[[BR]]后端接口（文章页接口-测试）:http://test1.pcgames.com.cn:8003/interface/pcgames/mrobot_articles_v3.jsp?id=4971942
[[BR]]后端接口（游戏信息接口-线上）:http://game.pcgames.com.cn/sy/intf/game/getgamedetail4cms.do?gameId=4849&callback=fixBox&code=gbk
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:参照1.基本约定
[[BR]]缓存时间:参照1.基本约定
[[BR]]说明:支持设置字体和读图模式
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||pageNo||int||可选||分页||
size=18    //字体大小(16,18,20）[[BR]]
picRule=1  //1无图，2大图，3小图[[BR]]

[[BR]]META参数:[[BR]]
||参数名||说明||
||pageCount||总页数||
||pageNo||当前页数||
||pages||每页标题||
||wap_url||wap链接||
||url||www链接||
||guidePic||导航图||

[[BR]]补充说明:[[BR]]
A、当游戏有android和ios版的时候，iOS直接跳转到appstore下载，android直接用机器自带的下载功能下载，不用在app里加入下载管理功能。[[BR]]
B、当游戏仅有iOS版的时候，android客户端看不到该信息接口。同理当仅有android版的时候，app客户端看不到该信息接口。[[BR]]
C、分享的链接请直接使用meta中的url字段。[[BR]]
具体可参考电脑网[[BR]]


==== 2.1.3 [=#point2.1.3 文章评论列表] ====
[[BR]]原mrobot接口: http://mrobot.pcgames.com.cn/v3/cmt/topics/13509342?reverse=0&support=1
[[BR]]现mrobot接口: http://mrobot.pcgames.com.cn/v3/cmt/new_topics/13509342?reverse=0&support=1
[[BR]]后端接口: http://cmt.pcgames.com.cn/action/comment/list_new_json.jsp?tId=13509342&arch=0&reverse=0&pageSize=20
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:返回数据改为json，分页返回数据，支持正倒序
||参数名||类型||必须||说明||
||pageNo||int||可选||分页||
||pageSize||int||可选||每页数量||
||reverse||int||可选||正倒序控制||
[[BR]]返回数据结构:参考电脑网文章评论列表http://mrobot.pconline.com.cn/v3/cmt/new_topics/13359138?pageNo=1&pageSize=20&reverse=0&articleId=6571490



=== 2.2 [=#point2.2 论坛模块] ===
==== 2.2.1 [=#point2.2.1 帖子列表] ====
[[BR]]原mrobot接口: http://mrobot.pcgames.com.cn/proxy/bbs/forums/27485?filter=pick&pageNo=1&pageSize=20
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:分页返回数据，支持三种排序：最近回复/最近发表/精华帖
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||


[[BR]]参数：
[[BR]]forumId：论坛ID 必须
[[BR]]pageNo：页码 可选
[[BR]]pageSize：每页条数，默认为20条。可选范围1-100。 可选
[[BR]]filter : 帖子类型（pick 精华贴，或留空） 可选
[[BR]]orderby : 排序类型，倒序（replycount 回复数，replyat 回复时间（默认），postat 发表时间） 可选
[[BR]]maxLength：帖子内容需要截取的长度，单位为字节，默认240。 可选

[[BR]]返回数据结构:
{{{
   成功：（成功时响应状态码为200）
{
    "forum": {
        "bbs": 27268,
        "forumId": 27612,
        "name": "玩家交流",
        "parentId": 27178
    },
    "pageNo": 1,
    "pageSize": 20,
    "topicList": [{
        "author": {
            "name": "二二炭",
            "nickname": "二二炭",
            "userId": 40477405
        },
        "createAt": 1433407504000,
        "flag": "图",
        "floor": 1,
        "image": "http:\/\/att.bbs.duowan.com\/forum\/201506\/04\/115337itz7kit7kmlftmdf.jpg",
        "message": "楼主我作为一名学（xue)霸(zha),秉承中华传（no)统(zuo)美(no)德(die),上课的时候画了一整套的《洛克精灵战记》毁灭之翼，
                   竟然还不知不觉上了色！作为一名精战高玩，
                   收服毁灭之翼，可是我的           至高理想！虽然现在未实现-_-。。。\n那么，开始上图。。：\n \n\n就...",
        "replyCount": 0,
        "title": "我上课时画的毁灭之翼，呵呵呵~",
        "topicId": 2979264,
        "uri": "http:\/\/bbs.pcgames.com.cn\/topic-2979264.html",
        "view": 2
    }],
    "total": 213
}
失败：（失败时响应状态码为40x或50x）
{
  "message" : "XXXXX" 
}
或
版块不存在或系统其他异常时无返回值。
}}}

==== 2.2.2 [=#point2.2.2 帖子终端页] ====
[[BR]]原mrobot接口: http://mrobot.pcgames.com.cn/v2/bbs/topics/topicId?pageNo=&pageSize=&
[[BR]]应用接口：http://bbs.pcgames.com.cn/rest/topics/2970513?pageNo=1&pageSize=100&picRule=3&topicTemplate=3.6.0&app=pcgamesbrowser&authorId=24719406
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:回帖加上回复楼层的功能，区分只看楼主和查看全部
[[BR]]说明:pcaction://reply?tid=2970513&pid=20543219&floor=6 回复楼层
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||topicId||int||必须||帖子ID||
||pageNo||int||可选||页码||
||picRule||int||可选||1没图，2大图，3小图||
||authorId||int||可选||不为0时表示只看该ID的回帖||
||desc ||boolean||可选||是否按楼层倒序读取回帖。此参数不为空时表示true||
||app||string||可选||pcgamesbrowser 客户端协议||


[[BR]]META参数:[[BR]]
||参数名||说明||
||pageCount||总页数||
||pageNo||当前页数||
||wap_url||wap链接||
||url||www链接||
||title||标题||
||userId||用户ID||


=== 2.3 [=#point2.3 搜索模块] ===
==== 2.3.1 [=#point2.3.1 资讯搜索] ====
[[BR]]原mrobot接口: http://mrobot.pcgames.com.cn/v3/cms/search?q=iphone&pageSize=4&pageNo=1&sort=time:asc
[[BR]]后端接口：http://ks.pcgames.com.cn/search.jsp?returnType=json&appName=games_cms_base&clustered=cluster_cat_gamescms&return=id,date,url,title,summary_store,tag&search=title&highlight=false&q=iphone&perPage=50&sort=time:desc&pageNo=1
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:根据关键字按时间返回资讯，分页
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||sort||string||可选||sort=time:asc 默认正序，sort=time:desc倒序||
||pageNo||int||可选||分页||
||pageSize||int||可选||每页数量||
||q||string||必须||搜索内容||
[[BR]]返回数据结构:
{{{
   {
    "start": 3,
    "perPage": 1,
    "curPage": 3,
    "total": 5479,
    "time": 0,
    "documents": [
        {
            "id": "4328120",
            "title": "经典桌游《圣符国度:数字版》增加支持iPhone",
            "tag": "圣符国度;卡牌RPG;游戏;手游",
            "summary_store": "由 Nomad Games 开发的经典桌游改编卡牌 R",
            "date": "",
            "url": ""
        }
    ],
    "statistic": {
        "cluster_cat_gamescms": [
            "掌机游戏_3917",
            "其他_558",
            "网络游戏_479",
            "手机游戏_362",
            "网页游戏_57",
            "电玩游戏_44",
            "电脑游戏_19",
            "游戏硬件_18",
            "电子竞技_12",
            "在线动漫_10",
            "小游戏_3"
        ]
    }
}
}}}


==== 2.3.2 [=#point2.3.2 帖子搜索] ====
[BR]]原mrobot接口: http://mrobot.pcgames.com.cn/v3/bbs/search?q=ios&forumId=28222
[[BR]]后端接口:http://ks.pcgames.com.cn/search.jsp?appName=games_bbs&return=id,login,title,forum,replycount,access,
authorId&highlight=false&returnType=json&q=path%3A28222+AND+%28title%3Aios+OR+summary%3Aios%29&perPage=10&pageNo=1

[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存方式:
[[BR]]缓存时间:
[[BR]]说明:根据关键字按时间返回帖子，分页
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||q||string||可选||查询字符串||
||forumId||int||必填||论坛ID||
||pageNo||int||可选||页数||
||pageSize||int||可选||每页数量||
||searchBy||string||可选||按searchBy搜索，可输入：summary，title，authorId||


[[BR]]返回数据结构:
{{{
    {
    "pageNo": 1,
    "pageSize": 1,
    "topicList": [
        {
            "access": "1",
            "authorId": "28233469",
            "createAt": 1398677366,
            "date": "2014-04-28 17:29:26",
            "forumId": 28222,
            "replycount": "1",
            "title": "《上古世纪》圣职测试放号今日开启",
            "topicId": 2838974,
            "userName": "by3our"
        }
    ],
    "total": 10
     }
}}}

=== 2.4 [=#point2.4 直播模块] ===
==== 2.4.1 [=#point2.4.1 直播列表页] ====
[[BR]]mrobot地址: http://mrobot.pcgames.com.cn/v3/live
[[BR]]直播wap地址：http://live.pcgames.com.cn/tuwen/wap/wapListInLine.jsp
==== 2.4.2 [=#point2.4.2 直播终端页] ====