Enter Game

The integrator initiates a user game entry request to the MINI.GAME platform, and the MINI.GAME platform returns a pre-generated game client URL.

Entergame

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

POST {MINIGAME_APIURL}/api/game/v1/entergame?trace_id=your_trace_id

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

Headers

Name	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
appid	string	The unique identifier for the merchant, available in the merchant backend.
timestamp	integer	Timestamp (in seconds)
token	string	The user's token on the MINI.GAME platform can be obtained through the Get User Game Token API.
currency	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
gameid	string	The ID of the game the user wishes to enter.
lang	string optional	Game language, default is "english"
screen_mode	string	The screen mode needs to be transferred only when the game type is lottery game, 1=>full screen, 2=>half screen (displayed in the lower half of the mobile phone screen)

Integrator Request Parameter Example

{
    "appid": "13",
    "token": "50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "currency":"usdt",
    "lang": "en",
    "gameid": "9",
    "timestamp": 1711954264
}

MINI.GAME Platform Response Parameter Example

Success

{
    "data": {
        "gameurl":"" 
    },
    "code": 0,
    "msg": "ok"
}

Failed

{
    "code": 10002,
    "msg": "sign invalid"
}

Response Example Parameter Descriptions

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

Error Code

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