Game Records

Player Game Record Description

YesPlayer game record description

• This interface is mainly used by merchants to query game records of player games.

• The interface is not related to the public description above

• MINI.GAME server time zone: UTC+0. Integrators should be mindful of time zone calculations when processing data statistics.

GetGameLogList

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

POST {BACKEND_URL}/api/special/outer/record/GetGameLogList?trace_id=your_trace_id

{BACKEND_URL} is the MINI.GAME configuration interface in the merchant backend where the domain for backend API calls can be obtained.

2. Public parameters (all API calls from the platform calling merchants must be included)

Parameter	Location	Required	Type	Description
sign	header	Yes	string	Signature Algorithm and Example
app_id	header	Yes	string	Merchant number
trace_id	url params	Yes	string	unique and randomly generated.

3.Interface parameters

Name	Location	Required	Type	Description
uname	body	No	string	User ID, matches the uname field used for game player verification.
game_id	body	No	integer	Game ID, If id=0, query all games
page	body	Yes	integer	Current Page
size	body	Yes	integer	Page Size
start_time	body	No	integer	Query Start Time: Timestamp in UTC+0
end_time	body	No	integer	Query End Time: Timestamp in UTC+0

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.

4.CallBack

When the HTTP status code returned by the integrator is 200, the API request is successful and the response can be parsed normally. For other HTTP errors, the connection is considered abnormal. When the return code is 200, the Content-Type will be "application/json;charset=UTF-8".

Example of a successful response:

{
    "code": 1,
    "msg": "success",
    "data": [
        {
            "uuid": "1806264170304233472",
            "create_time": 1719481910,
            "round_id": 1806264170304233472,
            "game_id": 10049,
            "account": "2024627172",
            "account_id": "1004613",
            "platform": "1",
            "usdt_exchange_rate": "1.0",
            "currency":"usdt",
            "bet": 1.0,
            "valid_bet": 1.0,
            "win": 0.0,
            "fee": 0.0,
            "enter_money": 50049.92,
            "after_settlement_money": 50049.92,
            "ip":"127.0.0.1",
            "uid":"100000001",
            "game_step": 0,
            "game_log" : ""
        },
        {
            "uuid": "1806264170304233472",
            "create_time": 1719481910,
            "round_id": 1806264170304233472,
            "game_id": 10049,
            "account": "2024627172",
            "account_id": "1004613",
            "platform": "1",
            "usdt_exchange_rate": "1.0",
            "currency":"usdt",
            "bet": 1.0,
            "valid_bet": 1.0,
            "win": 0.0,
            "fee": 0.0,
            "enter_money": 50049.92,
            "after_settlement_money": 50049.92,
            "ip":"127.0.0.1",
            "uid":"100000001",
            "game_step": 0,
            "game_log" : ""
        }
    ]
}

Response Field Description

Field	Required	Type	Length	Description
code	Yes	integer		Status Code
msg	Yes	string		Prompt message
uuid	Yes	string		Log unique id
create_time	Yes	integer		Timestamp
round_id	Yes	integer	35	Hand id
game_id	Yes	integer	20	Game id
account	Yes	string	45	Player nickname
account_id	Yes	string	45	Player id
platform	Yes	string	20	Game Brand
usdt_exchange_rate	Yes	string	45	The USDT exchange rate for the currency used at the time of recording
currency	Yes	string	20	Currency name, for details, see Public Description-7-Supported Currency Name Field
bet	Yes	decimal		Indicates the bet amount
valid_bet	Yes	decimal		Indicates the effective bet amount (usually the same as the bet amount)
win	Yes	decimal		Indicates the amount of the bonus.
fee	Yes	decimal		Service fee.
enter_money	Yes	decimal		Indicates the initial amount of the game
after_settlement_money	Yes	decimal		Indicates the money the player has after settlement
ip	Yes	string	20	Player IP address。
uid	Yes	string	20	Platform player id
game_step	Yes	Int	20	gamestep= 1, bet: bet; 2. dig: the player's in-game operation; 3. Cancel the bet; 0, settlement
game_log	Yes	string	200	An internal game object, with different meanings in different games.

Special Notes

If you need to display the player’s final win or loss, use Win - Bet to represent the player’s win or loss. For example: Bet: 50, Win: 10 The player’s win or loss is: 10-50 = -40.

When code is not 1, it means failure

{
    "code": 20001,
    "msg": "no merchant"
}

5 GameLog Details View

Merchants can directly access this details page to view the game records of the round.

URL https://manager.mini.game/gamelog?sign=sign&round_id=round_id&uid=uid&game_id=game_id&app_id=app_id&lang=lang

Request Parameters	Required	Type	Description
round_id	是	string	Game Match ID
uid	是	string	Player Log uID
game_id	是	string	Game ID
app_id	是	string	Merchant app_id
lang	否	string	Log display language	English (default), Currently supported languages: English (en), French (fr), Indonesian (id), Malay (ms), Vietnamese (vi), Traditional Chinese (tw)
sign	是	string	sign	Signature rules:sign = MD5(app_id=app_id&game_id=game_id&round_id=round_id&uid=uid[appkey])

Error Code

For more error codes, please refer to the Special Error Code page description.