pcgamesv2.0.0/interface – iphone

wiki:pcgamesv2.0.0/interface

Context Navigation

Version 24 (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://test1.pcgames.com.cn:8003/interface/pcgames/mrobot_articles_v3.jsp?id=4971942
后端接口（游戏信息接口-线上）: http://game.pcgames.com.cn/sy/intf/game/getgamedetail4cms.do?gameId=4849&callback=fixBox&code=gbk
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:参照1.基本约定
缓存时间:参照1.基本约定
说明:支持设置字体和读图模式
请求参数:

参数名	类型	必须	说明
pageNo	int	可选	分页

size=18 字体大小(16,18,20）
picRule=1 1无图，2大图，3小图

META参数:

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

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

2.1.3 文章评论列表

原mrobot接口: http://mrobot.pcgames.com.cn/v3/cmt/topics/13509342?reverse=0&support=1
现mrobot接口: http://mrobot.pcgames.com.cn/v3/cmt/new_topics/13509342?reverse=0&support=1
后端接口: http://cmt.pcgames.com.cn/action/comment/list_new_json.jsp?tId=13509342&arch=0&reverse=0&pageSize=20
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:返回数据改为json，分页返回数据，支持正倒序

参数名	类型	必须	说明
pageNo	int	可选	分页
pageSize	int	可选	每页数量
reverse	int	可选	正倒序控制

返回数据结构:参考电脑网文章评论列表 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
缓存方式:
缓存时间:
说明:分页返回数据，支持三种排序：最近回复/最近发表/精华帖
请求参数:

参数名

类型

必须

说明

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

返回数据结构:

   成功：（成功时响应状态码为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 帖子终端页

原mrobot接口: http://mrobot.pcgames.com.cn/v2/bbs/topics/topicId?pageNo=&pageSize=&
应用接口： http://bbs.pcgames.com.cn/rest/topics/2970513?pageNo=1&pageSize=100&picRule=3&topicTemplate=3.6.0&app=pcgamesbrowser&authorId=24719406
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:
说明:回帖加上回复楼层的功能，区分只看楼主和查看全部
说明:pcaction://reply?tid=2970513&pid=20543219&floor=6 回复楼层
请求参数:

参数名	类型	必须	说明
topicId	int	必须	帖子ID
pageNo	int	可选	页码
picRule	int	可选	1没图，2大图，3小图
authorId	int	可选	不为0时表示只看该ID的回帖
desc	boolean	可选	是否按楼层倒序读取回帖。此参数不为空时表示true
app	string	可选	pcgamesbrowser 客户端协议

2.3 搜索模块

2.3.1 资讯搜索

原mrobot接口: http://mrobot.pcgames.com.cn/v3/cms/search?q=iphone&pageSize=4&pageNo=1&sort=time:asc
后端接口： 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
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:
说明:根据关键字按时间返回资讯，分页
请求参数:

参数名	类型	必须	说明
sort	string	可选	sort=time:asc 默认正序，sort=time:desc倒序
pageNo	int	可选	分页
pageSize	int	可选	每页数量
q	string	必须	搜索内容

返回数据结构:

   {
    "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 帖子搜索

[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

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 资讯模块

2.1.1 资讯列表

2.1.2 文章终端页

2.1.3 文章评论列表

2.2 论坛模块

2.2.1 帖子列表

2.2.2 帖子终端页

2.3 搜索模块

2.3.1 资讯搜索

2.3.2 帖子搜索

2.4 直播模块

2.4.1 直播列表页

2.4.2 直播终端页

Download in other formats: