查询RTP

分页查询商户的 RTP 控制规则。可按玩家 ID 前缀或游戏 ID 筛选。

请求地址

POST {API_URL_ROOT}/RtpControl/Query

Request参数

Header内容

参数名 必填 类型 说明
sign 是 string 签名，使用签名算法计算得到
timestamp 是 int UTC 时间戳，单位秒，从 1970 年 1 月 1 日到现在所经过的秒数，如：1741837297
Accept-Language 是 string 接收的语言编码，参考语言列表，如：zh、en，以便在报错时返回对应语言的错误信息
Content-Type 是 string "application/json; charset=utf-8"

BODY内容

参数名 必填 类型 说明
tenantId 是 int 商户 ID，平台分配的唯一整数
userId 否 string 商户的玩家 ID；传入时按玩家 ID 前缀匹配
gameId 否 int 游戏 ID；传入时精确匹配
pageNumber 是 int 页码，从 1 开始
pageSize 是 int 每页数据条数

示例

{
  "tenantId": 1,
  "userId": "player",
  "gameId": 6,
  "pageNumber": 1,
  "pageSize": 20
}

Response参数

分页数据

参数名 类型 说明
totalCount int 符合条件的数据总条数
count int 当前页数据条数
pageNumber int 当前页码
pageSize int 每页数据条数
data array 当前页 RTP 控制规则列表

RTP控制规则

参数名 类型 说明
ruleId string RTP 控制规则 ID；取消控制时使用
tenantId int 商户 ID
userId string 玩家 ID
controlType int 控制类型，枚举值见下表
targetType int 控制目标类型，枚举值见下表
targetTypeName string 控制目标类型名称
targetId int 控制目标 ID；目标为游戏时即游戏 ID
targetName string 控制目标名称
changeRtp int 设置的 RTP 值
currentValue double 当前解除条件累计值，单位由 relievedType 决定
relievedType int 解除类型，枚举值见下表
relievedThreshold double 解除阈值，单位由 relievedType 决定
isCompleted boolean 是否已完成；true 为已完成，false 为控制中
createdAt string 规则创建时间，格式：yyyy-MM-dd HH:mm:ss

示例

{
  "isSuccess": true,
  "code": 0,
  "data": {
    "totalCount": 1,
    "count": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "data": [
      {
        "ruleId": "6897fcb02c0b34545b95a001",
        "tenantId": 1,
        "userId": "player001",
        "controlType": 1,
        "targetType": 2,
        "targetTypeName": "游戏名称",
        "targetId": 6,
        "targetName": "示例游戏",
        "changeRtp": 50,
        "currentValue": 3,
        "relievedType": 1,
        "relievedThreshold": 10,
        "isCompleted": false,
        "createdAt": "2026-08-10 10:30:00"
      }
    ]
  }
}

controlType 控制类型值列表

值 说明
1 输
2 赢

targetType 控制目标类型值列表

值 说明
1 游戏品牌
2 游戏

relievedType 解除类型值列表

值 说明 currentValue及relievedThreshold单位
1 局数 局
2 实时历史 RTP RTP 整数值，如 50 表示 50%
3 输赢金额 金额
4 指定时长 分钟

results matching ""

    No results matching ""