Request to Enter Game

The integrator calls this API to obtain the player's game entry link.

InGame

This API is provided by the MINI.GAME platform and is called by the integrator.

POST {MINIGAME_APIURL}/api/usr/ingame?trace_id=your_trace_id

{MINIGAME_APIURL}is the MINI.GAME API domain, which can be obtained from the backend.

Headers

Parameter	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

Please refer to the Signature Algorithm and Example page for details on the signature algorithm.

Body

Name	Type	Description
gameid	string	The game ID for the request to enter the game, which is the value of the gameid field in the game list.
token	string	User Verification Token Used for authentication in the single wallet interface.
currency	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
lang	string optional	Game language, default is "english".
nick	string	User nickname, up to 40 characters.
appid	string	The unique identifier for the merchant, available in the merchant backend.
screen_mode	string	Only games with Platform=100（MINI）,200 (lottery) , 300 (casino) need to transfer screen mode, 1=>Full screen vertically, 2=>Half screen (displayed in the lower half of the phone screen), 3=>Full screen horizontally
channel	string	Multiplayer games (currently only support the MINI, lottery , casino platforms); channel is a special parameter (optional by default) that is used to support notification grouping for the Special treatment for lottery games APIs, enabling separate notifications for different games within a live streaming room. If you are not using the Special treatment for lottery games API series, you can ignore this parameter.

Integrator Request Parameter Example

{
    "gameid":"2000001",
    "token":"50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "currency":"usdt",
    "lang":"en",
    "nick":"6396885064",
    "appid":"3",
    "channel":"1"
}

MINI.GAME Platform Response Parameter Example

Success

{
    "code": 0,
    "msg": "success",
    "data": {
        "gameurl": "https://www.****"
    }
}

Failed

Response Example Parameter Descriptions

Parameter	Required	Type	Description
code	Yes	integer	Status Code
msg	Yes	string	Prompt message
data	Yes	object	Response Data
gameurl	Yes	string	URL to launch the game client

Error Code

For more error codes, please refer to the General Error Codes page description.