# 登录游戏

### 接口描述

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

### 接入前准备

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

### 接口信息

**注意事项：**

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

**请求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' => '背包已满',
```