设置RTP控制
为一个或多个玩家设置指定游戏的 RTP 控制规则。同一玩家在同一游戏中存在未完成的规则时，不可重复设置。
请求地址
POST {API_URL_ROOT}/RtpControl/Create
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，多个 ID 使用英文半角逗号分隔。玩家必须已存在，ID 只能包含英文半角字符 |
| gameId | 是 | int | 游戏 ID，游戏必须存在且已上线 |
| controlType | 是 | int | 控制类型，枚举值见下表 |
| changeRtp | 是 | int | 要设置的 RTP 值，如 50 表示 50% |
| relievedType | 是 | int | 解除类型，枚举值见下表 |
| relievedThreshold | 是 | double | 解除阈值，单位由 relievedType 决定 |
示例
{
"tenantId": 1,
"userId": "player001,player002",
"gameId": 6,
"controlType": 1,
"changeRtp": 50,
"relievedType": 1,
"relievedThreshold": 10
}
Response参数
成功时返回通用成功响应。接口不会直接返回规则 ID；如需获取规则 ID，请调用查询RTP接口。
示例
{
"isSuccess": true,
"code": 0,
"message": "ok"
}
controlType 控制类型值列表
| 值 | 说明 |
|---|---|
| 1 | 输 |
| 2 | 赢 |
relievedType 解除类型值列表
| 值 | 说明 | relievedThreshold单位 |
|---|---|---|
| 1 | 局数 | 局 |
| 2 | 实时历史 RTP | RTP 整数值，如 50 表示 50% |
| 3 | 输赢金额 | 金额 |
| 4 | 指定时长 | 分钟 |