更新规则过期时间
更新时间不可用
更新指定封禁用户权限规则的过期时间。
PUT
https://api.sd-rtn.com/dev/v1/kicking-rule鉴权
Content-Typestringapplication/json。表示所有请求和响应内容的格式均为 JSON。
appidstring必填
项目的 App ID。可通过以下方式获取:
- 从声网控制台获取。
- 调用获取所有项目信息 API,并读取响应包体中
vendor_key字段的值。
idnumber必填
规则 ID。
timenumber封禁时间,单位为分钟,取值范围为 [1,1440]。
注意:
- 当设置的值在
0到1之间时,服务端自动改设为1。 - 当设置的值大于
1440时,服务端自动改设为1440。 time和time_in_seconds两个参数只需设置其中的一个。如果同时设置,则time_in_seconds生效;如果都不设置,服务端会自动将封禁时间设为 60 分钟,即 3600 秒。
time_in_secondsnumber封禁时间,单位为秒,取值范围为 [10,86430]。
注意:
- 当设置的值在
0到10之间,服务端自动改设为10。 - 当设置的值大于
86430时,服务端自动改设为86430。 time和time_in_seconds两个参数只需设置其中的一个。如果同时设置,则time_in_seconds生效;如果都不设置,服务端会自动将封禁时间设为 60 分钟,即 3600 秒。
响应
如果状态码为 200,则请求成功。
响应 Body
statusstring本次请求的状态。success 表示请求成功。
请求结果。
idnumber规则 ID。
tsstring该规则的过期时间(UTC 时间)。
请求示例
curl --request PUT \
--url "https://api.sd-rtn.com/dev/v1/kicking-rule" \
--header 'Authorization: Basic <credentials>' \
-H 'Content-Type: application/json' \
-d '{
"appid": "4855xxxxxxxxxxxxxxxxxxxxxxxxeae2",
"id": 1953,
"time": 60
}'响应示例
{
"status": "success",
"result": {
"id": 1953,
"ts": "2018-01-09T08:45:54.545Z"
}
}