更新规则过期时间

更新时间不可用

更新指定封禁用户权限规则的过期时间。

PUT
https://api.sd-rtn.com/dev/v1/kicking-rule

鉴权

Basic Auth

声网频道管理 RESTful API 仅支持 HTTPS。发送请求时,你需要使用声网提供的客户 ID 和客户密钥生成 Base64 编码凭证,并填入请求头部的 Authorization 字段中。详见实现 HTTP 基本认证。

请求 Header

Content-Typestring

application/json。表示所有请求和响应内容的格式均为 JSON。

请求 Body

appidstring
必填

项目的 App ID。可通过以下方式获取:

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 表示请求成功。

请求结果。

请求示例

Example Request
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"
  }
}