ApiDocument/transfer/zh/game_list.md

获得游戏列表

描述

获取子游戏列表

请求方式（ 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
		}
	]
}

失败的结果

 {
	"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+"_gameicon"+尺寸+"_"+语言编码+".png"

Icon获取示例

英文

正方形, 大小 300x300 (默认)

https://static.prod-topgame.com/gameicon/be025_game_icon_300x300_en.png

横向长方形, 大小 300x180（可选）

https://static.prod-topgame.com/gameicon/be025_game_icon_300x180_en.png

竖向长方形, 大小 225x300（可选）

https://static.prod-topgame.com/gameicon/be025_game_icon_225x300_en.png

中文

正方形, 大小 300x300 (默认)

https://static.prod-topgame.com/gameicon/be025_game_icon_600x600_zh.png

横向长方形, 大小 300x180（可选）

https://static.prod-topgame.com/gameicon/be025_game_icon_300x180_zh.png

竖向长方形, 大小 225x300（可选）

https://static.prod-topgame.com/gameicon/be025_game_icon_225x300_zh.png

印度尼西亚语

正方形, 大小 300x300 (默认)

https://static.prod-topgame.com/gameicon/be025_game_icon_300x300_id.png

横向长方形, 大小 300x180（可选）

https://static.prod-topgame.com/gameicon/be001_game_icon_300x180_id.png

竖向长方形, 大小 225x300（可选）

https://static.prod-topgame.com/gameicon/be001_game_icon_225x300_id.png

响应示例

• 大小 300x300

• 大小 300x180

• 大小 225x300