玩家RTP调控

用于对单个玩家RTP进行控制。RTP(游戏回报率)支持商户对单个玩家进行功能开启、关闭和修改,但是调控以后30天后自动过期

OMG服务器时区:UTC+0,接入方需注意数据统计的时区计算

RtpControl

该API接口由OMG平台提供,由接入方进行调用

POST {OMG_BACKEND_URL}/api/v1/merchant/outer/rtp/control?trace_id=your_trace_id

{OMG_BACKEND_URL} 为商户后台的API配置界面获取到的后台接口调用域名

Headers

Name
Value

Content-Type

"application/json; charset=utf-8"

sign

"your_sign_string"

签名算法请查阅 签名算法及示例 页面描述

Body

Name
Type
Description

app_id

string必填

后台获取的商户appid

uname

string必填

用户id,与游戏验证玩家的uname字段匹配,多个用户用逗号分开,如:106625,106626

rtp

integer

rtp 关闭时可不传 值:7000,7500,8000,8500,9000,9300,9500,9700,9900,10200,分别对应:70%-102%

switch

integer必填

当前开关 1 关 2开 如:switch=2时,rtp和max_win_multi_str必须要传一个

game_id

integer

游戏id,多个游戏用逗号分开,如:10039,10040,要调控所有游戏则game_id传空字符串即可

auto_cancel_rtp

integer

自动解除控制RTP,玩家到达指定RTP则自动取消控制功能值:7000,7500,8000,8500,9000,9500,9700,10200,分别对应:70%-102%

max_win_multi_str

string

控制玩家可赢取的最大赢奖倍数,传NULL表示不控制,若传的倍数超过商家游戏设定的最大倍数,则取最大倍数。

如果是多个用户多个游戏,则会控制/取消控制多用户下的多个游戏

请求参数示例 (单个玩家)

{
    "app_id": "10013",
    "uname": "1004613",
    "rtp": 9000,
    "switch": 2,
    "game_id": "10049"
}

请求参数示例 (多个玩家)

{
    "app_id": "10013",
    "uname": "1001726,1003401,1003402,1001719,1001720,1001721",
    "rtp": 9000,
    "switch": 2,
    "game_id": "100001,100002,100003,100004,10021"
}

响应参数示例

{
    "code": 1,
    "msg": "success"
}

成功返回示例的参数说明

返回值
是否必填
类型
说明

code

integer

状态码

msg

string

提示信息

错误码

更多返回错误代码请查阅 特殊错误码 页面描述

Last updated