游戏记录

玩家游戏记录说明

玩家游戏记录说明

• 该接口主要用于商户对玩家游戏的游戏记录进行查询

• 接口不与上面公共说明有关联

• MINIGAME的时区：UTC+0，接入方需注意数据统计的时区计算

1. GetGameLogList

该API接口由MINI.GAME平台提供,由接入方进行调用

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

{BACKEND_URL} 为商户后台的API配置界面获取到后台接口调用域名

2. 公共参数(平台调用商户所有API调用均需包含)

参数	所在位置	必选	类型	说明
sign	header	是	string	签名算法见 签名算法及示例
app_id	header	是	string	商户号
trace_id	url	是	string	每个请求都将有唯一的值

签名算法请查阅 签名算法及示例 页面描述

3、接口参数

参数	所在位置	必选	类型	说明
uname	body	否	string	用户id，与游戏验证玩家的uname字段匹配
game_id	body	否	Int	游戏id，如果id=0为查询所有游戏
page	body	是	Int	当前页
size	body	是	Int	查询条数
start_time	body	否	Int	查询起始时间 时间戳
end_time	body	否	Int	查询结束时间 时间戳

4、调用返回

当商户返回的http code为200时，为HTTP访问API正常，可正常解析返回结果。其余http错误时为链路异常。 200正常返回时，返回Content-Type为 “application/json;charset=UTF-8”

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

返回字段描述

返回值	是否必出	类型	长度	说明
code	是	integer		状态码
msg	是	string		提示信息
uuid	是	string		日志唯一id
create_time	是	Int		时间戳
round_id	是	Int	35	牌局id
game_id	是	Int	20	游戏id
account	是	string	45	玩家昵称
account_id	是	string	45	玩家id
platform	是	string	20	游戏品牌
usdt_exchange_rate	是	string	45	记录时所使用货币的usdt汇率
currency	是	string	20	货币名称，详情查看货币列表支持的货币的name字段
bet	是	decimal		表示下注金额
valid_bet	是	decimal		表示有效下注金额（一般情况下和下注金额相同）
win	是	decimal		表示派奖金额。
fee	是	decimal		服务费。
enter_money	是	decimal		表示游戏初始金额
after_settlement_money	是	decimal		表示结算之后玩家身上的钱
ip	是	string	20	玩家ip地址。
uid	是	string	20	平台玩家id。
game_step	是	Int	20	gamestep= 1，bet:下注； 2，dig:玩家局中操作； 3，：取消下注； 0，结算
game_log	是	string	200	游戏内部对象，不同游戏有不同含义。

特别说明

如需展示玩家的最终输赢，用Win - Bet即为玩家的输赢举例： Bet：50，Win：10 玩家输赢为：10-50 = -40

code不为1时,表示失败

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

错误码

游戏记录更多返回错误代码请查阅 特殊错误码 页面描述

5 GameLog 详细信息查看

该详情页面，商户可直接访问，查看该局游戏记录。

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

请求参数	是否必填	类型	说明
round_id	是	string	游戏对局ID
uid	是	string	日志玩家uID
game_id	是	string	游戏类型id
app_id	是	string	商户app_id
lang	否	string	显示语言	默认英语, 目前支持语言： 英语(en), 法语(fr), 印尼语(id), 马来语(ms), 越南语(vi), 中文繁体(tw)
sign	是	string	签名	签名规则：sign = MD5(app_id=app_id&game_id=game_id&round_id=round_id&uid=uid[appkey])

错误码

游戏记录更多返回错误代码请查阅 特殊错误码 页面描述