# <font > 游戏大厅接入 </font>
## 描述 

## 接入游戏大厅地址
```shell
对接环境地址: https://hall.stag-topgame.com
正式环境地址: 
```


## 接入游戏大厅流程
![游戏大厅](../../pic/hall_workflow_zh.png)

## 接入步骤
### 一、 发起url请求 [api/game/getKey](/zh/keys.md) 接口获取密钥

#### 获取密钥发起请求参数说明
| 名称     | 类型     | 必要    |     描述        | 
| -------- | -------- | -------- |    -------- |  
| cert     | string     |   Y |     安全代码 |
| user      |string (30) |  Y |      玩家账号|
| extension1 | string(20) | Y |      代理帐号 |

#### 获取密钥发起请求示例
```shell
Content-Type: application/x-www-form-urlencoded
请求方法: POST
请求地址：https://{api地址}/api/game/getKey


示例
curl -X POST 'https://api.stag-topgame.com/api/game/getKey' -F 'cert=v8VMKKzlPpD0te4rX99Hgefs3PQrBFWJKiuUqg6Y' -F 'user=adminw_qo68801mnj25o2nqu1u' -F 'extension1=adminweb'
```

#### 获取密钥返回结果字段说明
| 名称     | 类型     | 必要    |     描述        | 
| -------- | -------- | -------- |    -------- |  
| status   | string     |   Y |     状态代码 1表示成功，其他表示失败|
|key    |string (30) |  Y |     密钥|

#### 获取密钥返回结果示例示例
```shell
{
  "status": 1, 
  "key": "3F6AE577A2E2255EF4BACF02C9F8BB1154A6C7B77746366835F7250C896919F3B251654E75509490125E4966E52E8AB61D2A62FB40C0AEEFFC08C0EBCBA6AAEFAE4A", # 密钥
 
}
```







### 二、发起url请求获取大厅页面
- 通过第一步获取密钥(key),发起url GET请求就直接能获取大厅页面
#### 请求参数字段说明
| 名称      | 类型     |    描述        | 
| -------- | -------- |   --------		 |  
| tt     | string     | 通过获取密钥接口( [api/game/getKey](/zh/keys.md) )得到的key |
| lang   | string     | 语言 例如 en,zh,id 默认en |

#### 获取大厅页面请求示例
```shell
 https://hall.stag-topgame.com/?tt=3F6AE577A2E2255EF4BACF02C9F8BB1154A6C7B77746366835F7250C896919F3B251654E75509490125E4966E52E8AB61D2A62FB40C0AEEFFC08C0EBCBA6AAEFAE4A&lang=en
```


#### 返回大厅页面示例
![游戏大厅](../../pic/lobby.png)