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

方式：POST。

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

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

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

note

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

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

拉取游戏历史，必须使用专用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",
}