ApiDocument333/en/game_list.md

Get gamelist

Description

Get gamelist

Request mode (Host-> BeSoft) :post

Encoding method: application/x-www-form-urlencoded

The data format of the Besoft response is application/json

Method URL

{besoftapi}/api/game/subgamelist

Example

• URL:
  • http://127.0.0.1:8000/api/game/subgamelist
• HTTP Method
  • POST/GET

• Form Data

  extension1:testadmin
  

## Request parameters | Name | Type | Required | Description | | -------- | -------- | -------- | -------- | | extension1 | string | Y | Merchant account |

Parameter analysis of successful results

| Name | Type | Required | Description | | -------- | -------- | -------- | -------- |
| gameicourl | string | Y | Request game entry icon address | | gametype |string | Y | Game Type | | gid| string(20) | Y | Unique id to enter the game |

### Successful Result

{
	"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
		}
	]
}

The result of failure

 {
	"ret": 1616,
	"info": "ip address error"
}

Login

Descripti on

Invoke this method with your “Key” (returned by GetKey API) to launch game.

Game return description: After the game is closed, the return address (return_url= the parameter of the return address), if not filled in, the game has no return button.

Method URL

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

New interface: If you need to close the current window directly, please use the window.open mode to open, and do not need to pass the return_url

New interface: If the parameter return_url is added, please encode the parameter in URLEncoding mode

Embedded interface: If it is embedded, please listen for this message notification (closeMessage), the game manufacturer closes the game's call interface

{
   window.parent.postMessage("closeMessage", "*")
}

Request Parameter

| Name | Type | Required | Description | | -------- | -------- | -------- | -------- |
| acc | String(30) | Y | User ID | | key |string(86) | Y |1.Key value returned by “GetKey” , 2.Please do URLEncoding on it while using the HTTP GET method) | | aid | string(20) | Y | Agent Id | | nick | string (50) | Y | User name Only Support 16 Unicode characters | | gid| Integer | Y| input gameId as default launch game ; if blank, go to lobby. | | lang| string | Y| default is cn , cn : simplified Chinese , en : english | | return_url | string | N | return_url=Game off return address，Please encode the parameters in URLEncoding mode |

Return Result

Successful Result

Redirect Browser to game hall page

Failed Result

The game interface displays the corresponding error message.

Method for piecing together the address of the game entrance icon request

gameicourl+/+ gid+"_gameicon"+Size+"_"+"Language encoding"+.png"

Icon Get example

English

Square, Size  300x300 (Default)

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

Horizontal rectangle, Size 300x180（Optional）

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

Vertical rectangle, Size 225x300（Optional）

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

Chinese

Square, Size  300x300 (Default)

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

Horizontal rectangle, Size 300x180（Optional）

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

Vertical rectangle, Size 225x300（Optional）

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

Bahasa Indonesia

Square, Size  300x300 (Default)

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

Horizontal rectangle, Size 300x180（Optional）

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

Vertical rectangle, Size 225x300（Optional）

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

Response sample

• Size 300x300

• Size 300x180

• Size 225x300