最后更新时间： 2021-02-04 03:12:47 PM

登录游戏

接口描述

游戏登录是玩家在GTa平台进入游戏服务器的唯一入口，由平台提供标准的接口文档（参数含义确定、签名约定），由游戏方提供游戏服域名和通用pathInfo；

接入前准备

运营在开服系统配置测试服
游戏运维配置测试服务器
研发提供测试版本、进游戏通用pathInfo
平台请求系统运维给拉服pkey加上新的游戏，包括海外版和全球版的pkey（找莫等闲添加）

接口信息

注意事项：

网页版请求该接口校验成功，游戏前端直接进入游戏，无需返回信息给平台。微端pc版需要返回进游戏相关参数，游戏客户端根据参数自己实现进游戏功能

请求URL：

https://{domain}/game

具体pathInfo {domain为游戏服域名} /game可变，仅供参考，

请求方式：

GET

参数格式

k=v

请求参数：

参数名	必选	类型	说明
account	是	string	GTa平台账号
ip	是	string	玩家客户端ip
time	是	int	进游戏时间，当前时间戳
game_id	是	int	当前游戏game ID，统一由游族开服系统给出
lang	是	string	当前玩家所选择平台语种，值参考GTa平台语言规范，默认英文 en-us
uuzu_op_id	是	int	运营商平台ID, 默认 GTa平台： 590
sid	是	string	玩家所选择的当前游戏的游戏服Id
country	是	string	国家简称CN，或不识别为empty，支持ipv4和ipv6
source	是	string	默认平台:gta, 广告： ad, 品牌： brand
guest_upgrade	是/否	int	平台官网必须： 0 非游客账号，1 游客账号未升级 2 游客账号已升级，微端非必须
verify	是	string	接口签名，签名方式见统一签名
platform	否	string	微端非网页版接入必传参数， windows微端gta版本：app，windows air版本：air, windows air版下载：download， mac gta微端版本：mac, mac air版本：air_mac, mac air版下载地址：download_mac
ad_info	否	string	广告信息，广告识别标志
is_new	否	int	1,新玩家 0,老玩家或滚服玩家根据游戏需求开放，默认关闭
refer	否	string	人拉人过来的url，记录用户访问进游戏来源
adult_flag	否	int	是否成年默认，1，成年
game_time	否	int	默认0
client_type	否	int	默认不传值，网页，2,代表微端，微端独有参数
loa_fb	否	string	默认： json_encode(array(‘miniloader’ => 1))，gta微端独有参数

请求示例

女神3进游戏地址：

https://sn-nslm3.gtarcade.com/gm/gtarcade/pt/game?account=submitpaper123%40163.com&adult_flag=1&game_time=0&ip=103.108.8.70&time=1544585545&game_id=312&lang=en-us&is_new=0&country=%2A&uuzu_op_id=590&sid=1448310263&verify=78b0abd63e8043e3c42ca3fb8a611

返回数据

网页进游戏：
成功：直接进入游戏，无需任何返回值
失败：黑屏，鼠标选中和平可以看到错误提示,code值含义参考下面错误码列表

  {
    "code": 5
  }

微端pc方式接入，进游戏接口返回json格式参数（游戏服务端返回游戏客户端进游戏所需的参数，平台只进行数据透传，游戏方自定义,如下是部分参数demo，平台微端客户端，会把这些值传递给游戏客户端）

{
    "clientJson": {
        "appVersion": "1.13.1_485ad",
        "dataServerUri": "https://cdn-zs-studio.gtarcade.com/product-346/cdn1/S0",
        "forceSecureConnection": true,
        "lockResVersion": true,
        "logLevel": 2,
        "resVersion": "1.13.1_485a,
        "secretKey": "hanmeime"
    }
}

错误码

'1' => '校验码错误',
'2' => '时间过期',
'3' => '缺少参数',
'4' => '订单号重复',
'5' => '订单号不存在',
'6' => '玩家帐号不存在',
'7' => '充值金额不合法',
'8' => '排行榜类型不存在',
'9' => '角色名不合法',
'10' => '角色名已经被使用',
'11' => '帐号已存在',
'12' => '定单不存在',
'12' => '奖励编号无效',
'13' => '背包已满',

搜索结果