Action 71：查询玩家的免费场次资讯

功能说明

查询玩家的免费场次资讯
免费场次资讯保留至场次过期后 180 天内

参数

参数	格式	强制	说明
action	Integer	Y	71
ts	Long	Y	当前系统时间
parent	String(50)	Y	代理账号
uid	String(50)	Y	玩家账号
startTime	String	N	免费场次开始时间查询区段起始时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
endTime	String	N	免费场次开始时间查询区段结束时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
status	Integer	N	免费场次状态未启用：0 启用：1 过期：2 终止：3
types	String Array	N	免费场次类别 NORMAL: 一般游戏 FEATURE: 特色游戏 BONUSCHIPS: 红利筹码游戏
mysteryTypes	String Array	N	开奖类型 NONE: 無（默认） BLINDBOX: 盲盒开发中

Example


{
  "action": 71,
  "ts": 1704790101741,
  "parent": "testag",
  "uid": "testplayer",
  "startTime": "2024-07-22T04:05:33.000+01:00",
  "endTime": "2024-07-23T04:05:33.000+01:00",
  "status": 1,
  "types": ["NORMAL", "FEATURE"],
  "mysteryTypes": ["NONE", "BLINDBOX"]
}

返回结果

参数	格式	说明
status	String(4)	成功：0000 错误：参照附录错误代码
data	JSON Array	`回传的数据组将列于下表中`
err_text	String(255)	错误讯息

免费场次游戏详细内容

参数	格式	说明
eventId	String	免费场次识别代号
name	String	免费场次名称
currency	String(10)	货币别参照附录货币代码
type	String	免费场次类别 NORMAL: 一般游戏 FEATURE: 特色游戏 BONUSCHIPS: 红利筹码游戏
featureType	String	特色游戏类型 `特色游戏此欄位才會有值，否则為 null`
times	Long	免费场次可使用次数 `一般游戏、特色游戏此欄位才會有值，否则為 null`
useTimes	Long	玩家已使用次数 `一般游戏、特色游戏此欄位才會有值，否則為 null`
requiredTurnover	String	筹码流水要求 `紅利籌码游戏此欄位才會有值，否則為 null`
accumulatedTurnover	String	玩家目前累积流水 `紅利籌码游戏此欄位才會有值，否則為 null`
startTime	String	免费场次开始时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
endTime	String	免费场次结束时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
status	String	免费场次状态 INACTIVE: 未启用 ACTIVE: 启用 EXPIRED: 过期 TERMINATED: 终止
machineTypes	Integer Array	机台类型参照附录游戏列表（4.2）
alreadySettle	Boolean	免費場次是否已結算 `如果是一般游戏、特色游戏：当玩家使用完免费场次的次数时，此欄位为 true 否则为 false` `如果是红利筹码游戏：当玩家用完红利筹码或是达成筹码流水要求时，此欄位为 true 否则为 false`
cashout	String	玩家提取金额
updateTime	String	更新时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+\|-hh:mm
mysteryType	String	开奖类型 NONE: 無 BLINDBOX: 盲盒
visible	Boolean	玩家是否可看见免费场次 `若盲盒类型為 NONE 此欄位默认为 true` `若盲盒类型為 BLINDBOX 此欄位默认为 false` `盲盒类型免费场次需要由玩家在游戏中抽奖后激活`

操作范例


// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
    "status": "0000",
    "data": [
        {
            "eventId": "12345",
            "name": "test normal event name",
            "currency": "RB",
            "times": 3,
            "useTimes": 3,
            "requiredTurnover": null,
            "accumulatedTurnover": null,
            "startTime": "2024-07-17T16:00:00.000+01:00",
            "endTime": "2024-07-22T16:00:00.000+01:00",
            "type": "NORMAL",
            "status": "EXPIRED",
            "machineTypes": [
              14050,
              14053
            ],
            "alreadySettle": true,
            "cashout": "1.000",
            "updateTime": "2024-07-22T16:00:00.000+01:00",
            "mysteryType": "NONE",
            "activation": true
        },
        {
            "eventId": "12346",
            "name": "test feature event name",
            "currency": "RB",
            "times": 5,
            "useTimes": 2,
            "requiredTurnover": null,
            "accumulatedTurnover": null,
            "startTime": "2024-07-17T16:00:00.000+01:00",
            "endTime": "2024-07-22T16:00:00.000+01:00",
            "type": "FEATURE",
            "featureType": "FEATURE_BUY_01",
            "status": "ACTIVE",
            "machineTypes": [
              14093,
              14089
            ],
            "alreadySettle": false,
            "cashout": "0",
            "updateTime": "2024-07-22T16:00:00.000+01:00",
            "mysteryType": "NONE",
            "activation": true
        },
        {
            "eventId": "12347",
            "name": "test bonus chips event name",
            "currency": "RB",
            "times": null,
            "useTimes": null,
            "requiredTurnover": 100,
            "accumulatedTurnover": 50,
            "startTime": "2024-07-17T16:00:00.000+01:00",
            "endTime": "2024-07-22T16:00:00.000+01:00",
            "type": "BONUSCHIPS",
            "status": "EXPIRED",
            "machineTypes": [
              14041,
              14087
            ],
            "alreadySettle": true,
            "cashout": "0",
            "updateTime": "2024-07-22T16:00:00.000+01:00",
            "mysteryType": "BLINDBOX",
            "activation": false
        }
    ]
}
 
// Http Response (failed)
1. 若查询玩家非代理下线，我方会回传：
{
    "status": "7501",
    "err_text": "User ID cannot be found."
}
 
2. 若查询区段起始时间大于查询区段结束时间，我方会回传：
{
    "status": "8009",
    "err_text": "Time interval exceeds the allowable range."
}