# <font >获得游戏列表</font>
## 描述
> 获取子游戏列表

> 请求方式（ Host-> BeSoft）:post 

> 编码方式：application/x-www-form-urlencoded

> Besoft响应的数据格式是: application/json


## 网址
>  {besoftapi}/api/game/subgamelist




## 示例
- URL:
    - http://127.0.0.1:8000/api/game/subgamelist
- HTTP Method(请求方式)
    -   POST/GET
- 表单数据
> Content-Type: application/x-www-form-urlencoded
``` 
    extension1:testadmin
   ```
   
 ## 请求参数
| 名称     | 类型     | 必要    |     描述        | 
| -------- | -------- | -------- |    -------- |  
| extension1     | string     |   Y |     商户账号 |



##  成功结果的参数解析
| 名称     | 类型     | 必要    |     描述        | 
| -------- | -------- | -------- |    -------- |  
| gameicourl    | string     |   Y |     请求游戏入口icon地址 |
| gametype   |string |  Y |   游戏类型 |
| gid| string(20) | Y |  进入游戏的唯一id  |



 ### 成功的结果
```
{
	"gameicourl": "http://127.0.0.1:8000/gameicon",
	"gamelist": [
		{
			"gid": "be001",
			"name": "Dragon Stash",
			"gametype": "1",
			"hot": 1,
			"new": 0
		},
		{
			"gid": "be002",
			"name": "Jungle Fruit",
			"gametype": "1",
			"hot": 1,
			"new": 1
		}
	]
}
```


## 失败的结果
```json
 {
	"ret": 1616,
	"info": "ip address error"
}
```




##  进入游戏

### 描述
>使用“key”（由 getkey api 返回）调用此方法以启动游戏。

>游戏返回说明：游戏关闭后，返回的地址（return_url=返回地址的参数）,如果不填写，游戏没有返回按钮。


## 网址
```
http://{BesoftFront}/?key=3F6AE577A2E2255EF4BACF02C9F8BB1154A9C6AD2F19701
568BA675BDA3C46BCA64D243007F87C86119329271708&gid=be001&lang=en&return_url=https://returnyoururl.com

```
>新开界面：如果需要直接关闭当前窗口，请使用window.open方式打开，并且不需要传入return_url


>新开界面：如果加入return_url参数,请以URLEncoding方式编码参数


>内嵌界面：如果是内嵌请监听此消息通知（closeMessage），游戏厂商关闭游戏的调用接口
```
{
   window.parent.postMessage("closeMessage", "*")
}

```


## 请求参数

| 名称     | 类型     | 必要    |     描述        | 
| -------- | -------- | -------- |    -------- |  
| acc     | String(30)     |   Y |     用户ID |
| key     |string(86) |  Y |从 getKey 接口拿到的 key。若使用 HTTP GET 方法，请以 URLEncoding 编码参数|
| aid | string(20) | Y |      代理帐号  |
| nick | string (50) | Y |     用户名，最多支持 16 个 Unicode 字节  |
| gid | Integer | Y |      预设登入的游戏 ID ;  |
| lang | string | Y |      默认值为简中 (简中 英文) |
| return_url | string | N |      return_url=游戏关闭的返回地址 ，请以URLEncoding方式编码参数|
##  返回结果

### 成功的结果

>Redirect Browser to gamehall page; 导引至游戏页面

### 失败的结果

>游戏界面显示相应的错误信息






##  请求游戏入口icon地址的拼接方法
> gameicourl+/+ gid+"_game_icon_"+尺寸+"_"+语言编码+".png"


##  Icon获取示例
### 英文
```
正方形, 大小 300x300 (默认)

https://game.besoft-game.top/gameicon/be025_game_icon_300x300_en.png
```
```
横向长方形, 大小 300x180（可选）

https://game.besoft-game.top/gameicon/be025_game_icon_300x180_en.png
```
```
竖向长方形, 大小 225x300（可选）

https://game.besoft-game.top/gameicon/be025_game_icon_225x300_en.png
```

### 中文
```
正方形, 大小 300x300 (默认)

https://game.besoft-game.top/gameicon/be025_game_icon_600x600_zh.png
```
```
横向长方形, 大小 300x180（可选）

https://game.besoft-game.top/gameicon/be025_game_icon_300x180_zh.png
```
```
竖向长方形, 大小 225x300（可选）

https://game.besoft-game.top/gameicon/be025_game_icon_225x300_zh.png
```


### 印度尼西亚语
```
正方形, 大小 300x300 (默认)

https://game.besoft-game.top/gameicon/be025_game_icon_300x300_id.png
```
```
横向长方形, 大小 300x180（可选）

https://game.besoft-game.top/gameicon/be001_game_icon_300x180_id.png
```
```
竖向长方形, 大小 225x300（可选）

https://game.besoft-game.top/gameicon/be001_game_icon_225x300_id.png
```

##  响应示例

- 大小 300x300

![600x600](../../pic/be025_game_icon_300x300_en.png)

- 大小 300x180

![600x600](../../pic/be025_game_icon_300x180_en.png)

- 大小 225x300

![600x600](../../pic/be025_game_icon_225x300_en.png)