拉取游戏额外奖励交易信息
- John Chen
URl: https://{{gmag_game_data_url}}/history/extraTrans?hash={{xxx}}。
方式：POST。
目的：用于根据交易产生时间获取玩家的交易记录(推广活动/ 锦标赛)。
在API的响应中，游戏交易的最大条数为10,000条。
拉取游戏交易信息，必须使用专用API域名gmag_game_data_url。关于实际名称，请查看GM-Ag发送的开户信息相关内容。
请求
参数名 | 类型 | 必选 | 参数说明 |
|---|---|---|---|
startTime | String(32) | 是 | GMT+0的日期和时间 |
endTime | String(32) | 是 | GMT+0的日期和时间 |
size | Int | 否 | 每页交易的条数，默认值 = 5000。 |
page | Int | 否 | 页码值，默认值 = 1。 |
playerId | String(24) | 否 | 玩家的唯一标识，用于获取某个玩家的交易信息。 |
showAll | Int | 否 | 1 - 包含子代理，0 - 不包含子代理。默认为0。 |
providerCode | String(32) | 否 | 游戏供应商唯一标识，用户获取某个供应商的交易信息 |
currency | String(8) | 否 | 根据玩家货币获取交易信息 |
响应
参数名 | 类型 | 必选 | 参数说明 |
|---|---|---|---|
total | Int | 是 | 游戏交易的总条数 |
pages | Int | 是 | 交易的总页数 |
size | Int | 是 | 每页交易的条数 |
current | Int | 否 | 当前的页码 |
records | Array | 是 | extraTrans数据的数组，可以为空。 |
ExtraTrans数组元素
参数名 | 类型 | 必选 | 参数说明 |
|---|---|---|---|
transId | String(64) | 是 | 游戏交易的唯一标识 |
playerId | String(24) | 是 | 玩家的唯一标识 |
brandId | bigInt | 是 | 代理的唯一标识 |
providerCode | String(8) | 是 | 游戏供应商的编码 |
currency | String(8) | 是 | 交易的币种编码 |
amount | numeric(16, 4) | 是 | 交易的金额(包含奖池赢取金额jpw) |
balanceBefore | numeric(16, 4) | 是 | 交易发生前，玩家的余额 |
balanceAfter | numeric(16, 4) | 是 | 交易发生后，玩家的余额 |
transTime | DateTime | 是 | 交易操作的时间 |
referenceId | String(64) | 是 | 活动ID |
referenceName | String(512) | 否 | 活动名称 |
description | String(2048) | 否 | 描述 |
请求例子
{
"requestId": "requestId1234",
"brandId": "222",
"startTime": "2024-09-11 01:30:00",
"endTime": "2024-09-11 01:45:00",
"size": 1000,
"page": 1
}响应例子
//success
{
"requestId": "requestId1234",
"error": "0",
"message": "SUCCESS",
"total":2200,
"size":1000,
"current":1,
"pages":2,
"records": [
{
"transId": "10003",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:35:15.220",
"amount": 0,
"currency": "CNY",
"balanceBefore": 975055.89,
"balanceAfter": 975055.89,
"referenceId": "10003",
"referenceName":"10003",
},
{
"transId": "10004",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:36:21.495",
"amount": 0.09,
"currency": "CNY",
"balanceBefore": 975055.89,
"balanceAfter": 975055.98,
"referenceId": "10004",
"referenceName":"10004"
},
{
"transId": "10005",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:36:40.632",
"amount": 0.09,
"currency": "CNY",
"balanceBefore": 975055.98,
"balanceAfter": 975056.07,
"referenceId": "10005",
"referenceName":"10005",
"description":"10005"
}
]
}
//error
{
"requestId": "requestId1234",
"error": "P_02",
"message": "Invalid hash",
}