# <font > Game Lobby access </font>
## Description 

## Game Lobby Access Addresses
```shell
Staging environment address: https://hall.stag-topgame.com
Production environment address: https://hall.prod-topgame.com
```


## Game Lobby Integration Workflow
![游戏大厅](../../pic/hall_workflow_en.png)

## Access Steps
### 1. Initiate URL Request to  ([api/game/getKey](/en/keys.md)) interface to obtain key

#### Request Parameters
| Name     | Type     | Required    |     Description        | 
| -------- | -------- | -------- |    -------- |  
| cert     | string     |   Y |     Security code |
| user      |string (30) |  Y |      Player account|
| extension1 | string(20) | Y |      Agent account |

#### Request Example
```shell
Content-Type: application/x-www-form-urlencoded
Method: POST
Endpoint：https://{api_address}/api/game/getKey


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

#### Response Parameters
| Name     | Type     | Required    |     Description        | 
| -------- | -------- | -------- |    -------- |  
| status   | string     |   Y |     Status code (1 = success, others = failure)|
|key    |string (30) |  Y |     Secret key|

#### Response Example
```shell
{
  "status": 1, 
  "key": "3F6AE577A2E2255EF4BACF02C9F8BB1154A6C7B77746366835F7250C896919F3B251654E75509490125E4966E52E8AB61D2A62FB40C0AEEFFC08C0EBCBA6AAEFAE4A", # Secret key
 
}
```


### 2. Initiate URL Request to Access Lobby Page
- Use the secret key obtained in Step 1 to make a GET request
#### Request Parameters
| Name      | Type     |    Description        | 
| -------- | -------- |   --------		 |  
| tt     | string     |  Key obtained from( [api/game/getKey](/en/keys.md) )interface |
| lang   | string     | Language code (e.g. en, zh, id). Default: en |

#### Request Example
```shell
 https://hall.stag-topgame.com/?tt=3F6AE577A2E2255EF4BACF02C9F8BB1154A6C7B77746366835F7250C896919F3B251654E75509490125E4966E52E8AB61D2A62FB40C0AEEFFC08C0EBCBA6AAEFAE4A&lang=en
```


#### Lobby Page Response Example
![Game Lobby](../../pic/lobby_1.png)