拉取游戏历史

URl: https://{{gmag_game_data_url}}/history/game?hash={{xxx}}。

方式：POST。

目的：用于根据游戏结算时间获取玩家已经结算了的游戏历史数据，如果玩家某一局游戏未结算，将无法拉取到，拉取的最长时间段为30分钟。

代理调用 gameHistory 命令的时长最小单位为分钟。在 GM-Ag 系统中，最近30天的游戏记录为可访问记录，超过30天的记录不能被拉取到。

在API的响应中，游戏历史的最大条数为10,000条。

拉取游戏历史，必须使用专用API域名gmag_game_data_url。关于实际名称，请查看GM-Ag发送的开户信息相关内容。

拉取到的数据如果之前已经拉到，请根据roundid更新之前的数据，每个roundid只保留一条数据。

请求

参数名	类型	必选	参数说明

参数名	类型	必选	参数说明
startTime	String(32)	是	GMT+0的日期和时间格式: YYYY-MM-DD HH:mm:00 请注意，秒数值固定为00，任何非零秒数必须转换为00。
endTime	String(32)	是	GMT+0的日期和时间格式: YYYY-MM-DD HH:mm:00 请注意，秒数值固定为00，任何非零秒数必须转换为00。 endTime - startTime 必须小于 30 分钟。
size	Int	否	每页游戏数据的条数，默认值 = 5000。最大10000
page	Int	否	页码值，默认值 = 1。
showAll	int	否	1 - 包含子代理，0 - 不包含子代理。默认为0
roundId	String(64)	否	回合的标识，用于获取某个游戏回合的游戏记录。
playerId	String(24)	否	用于获取某个玩家的游戏历史记录
providerCode	String(24)	否	用于获取某个游戏供应商的游戏历史记录
currency	String(8)	否	用于获取某个货币的游戏历史记录
gameCode	String(63)	否	用于获取某个游戏的游戏历史记录

响应

参数名	类型	必选	参数说明

参数名	类型	必选	参数说明
total	Int	是	游戏记录的总条数
pages	Int	是	记录的总页数
size	Int	是	每页游戏记录的条数
current	Int	否	当前的页码
records	Array	是	GameHistory数据的数组，可以为空。

GameHistory数组元素

参数名	类型	必选	参数说明

参数名	类型	必选	参数说明
brandId	bigInt	是	代理的唯一标识
playerId	String(24)	是	玩家的唯一标识
providerCode	String(32)	是	游戏供应商的编码
sessionId	String(32)	是	游戏会话的唯一标识
roundId	String(127)	是	游戏回合的唯一标识
gameCode	String(32)	是	游戏记录的游戏代码
currency	String(8)	是	游戏记录的币种编码
platform	String(16)	否	启动游戏的玩家设备平台（web, mobile, download）
bets	numeric(16, 4)	是	押注的金额
wins	numeric(16, 4)	是	赢取的金额
cancels	numeric(16, 4)	是	取消的金额
transIn	numeric(16, 4)	否	转账到游戏的金额
transOut	numeric(16, 4)	否	转账到玩家的金额
balanceEnd	numeric(16, 4)	是	回合完成后的玩家余额
bonusBalanceEnd	numeric(16, 4)	是	回合完成后的奖金账号余额
rake	numeric(16, 4)	否	抽水的金额
startTime	DateTime	是	回合开始的时间
endTime	DateTime	是	回合结束的时间
jpc	numeric(16, 4)	否	累积奖金池的贡献
jpw	numeric(16, 4)	否	当transType = ‘win’，奖金池赢取的金额
jpDetails	text	否	奖金池赢取的详细信息，如id
roundType	String(16)	是	回合的类型（normal, freegame, bonusgame）
roundStatus	String(8)	是	回合的状态
additionalData	text	否	游戏记录的额外参数及参数值
detailUrl	String(1024)	否	游戏的详情的链接，有些平台暂时无法提供此链接
gameType	String(16)	是	`slots`,`table`,`live`,`arcade`,`sport`,`esport`,`lotto`, `poker`,`bingo`, unknown(gameCode无法识别时)
createdAt	DateTime	是	创建时间

请求例子

{
    "requestId": "requestId1234",
    "brandId": "1001",
    "startTime": "2021-06-10 10:00:00",
    "endTime": "2021-06-10 10:05:00",
    "size": 1000,
    "page": 1,
}

响应例子

//success
{
    "requestId": "request5282",
    "error": "0",
    "message": "SUCCESS",
    "total": 2,
    "current": 1,
    "size": 5000,
    "pages": 1,
    "records": [
        {
            "playerId": "palyerid1",
            "brandId": 1001,
            "providerCode": "pt",
            "sessionId": "03d35793716348cabf5a202ef823a86f",
            "roundId": "583067326075",
            "roundType": "normal",
            "roundStatus": "end",
            "gameCode": "bfb",
            "currency": "CNY",
            "platform": "web",
            "bets": 5.0000,
            "wins": 10.0000,
            "cancels": 0.0000,
            "transIn": 0.0000,
            "transOut": 0.0000,
            "balanceEnd": 2652.0500,
            "bonusBalanceEnd": 0.0000,
            "rake": 0.0000,
            "startTime": "2021-08-11 15:48:23.745",
            "endTime": "2021-08-11 15:48:24.038",
            "createdAt": "2021-08-11 15:48:24.038",
            "jpc": 0.1235,
            "jpw": 5.0000,
            "jpDetails": [
                {
                    "id": "123124",
                    "contribution": 0.12345,
                    "win": 0.12345
                }
            ],
            "gameType": "slots",
            "detailUrl": "https://extstg3-cashier01.ptstaging.eu/getgamehistory.php?ThisIsJustAutomatedTestDataOK"
        },
        {
            "playerId": "palyerid1",
            "brandId": 1001,
            "providerCode": "pt",
            "sessionId": "03d35793716348cabf5a202ef823a86f",
            "roundId": "398521759399",
            "roundType": "normal",
            "roundStatus": "end",
            "gameCode": "bfb",
            "currency": "CNY",
            "platform": "web",
            "bets": 5.0000,
            "wins": 10.0000,
            "cancels": 0.0000,
            "transIn": 0.0000,
            "transOut": 0.0000,
            "balanceEnd": 2657.0500,
            "bonusBalanceEnd": 0.0000,
            "rake": 0.0000,
            "startTime": "2021-08-11 15:48:24.342",
            "endTime": "2021-08-11 15:48:24.870",
            "createdAt": "2021-08-11 15:48:24.038",
            "jpc": 0.0000,
            "jpw": 0.0000,
            "gameType": "slots",
            "detailUrl": "https://extstg3-cashier01.ptstaging.eu/getgamehistory.php?ThisIsJustAutomatedTestDataOK"
        }
    ]
}
//error
{
   "requestId": "requestId1234",
   "error": "P_02",
   "message": "Invalid hash",
}

GM-Ag API Guide

拉取游戏历史

请求

响应

GameHistory数组元素

请求例子

响应例子

Related content