跳到主要内容

添加用户限制

添加用户对话限制记录,限制用户与指定 Agent 的对话权限。

请求方法

POST:https://数据中心域名/v3/agent/user/restriction/add.json

签名规则:所有服务端 API 请求均需要进行规则校验,详见 API 请求签名

请求参数

HTTP 请求正文数据格式为 application/json,支持以下参数:

参数类型必传说明
agentIdStringAgent ID,长度 0-64 个字符。
userIdString用户 ID。
typeInt限制类型,参考限制类型枚举。

限制类型枚举

type说明
1完全禁止用户使用指定 Agent

请求示例

HTTP
POST /v3/agent/user/restriction/add.json HTTP/1.1
Host: api.rong-api.com
App-Key: e0x9wycfx7flq
Nonce: 1068826355
Timestamp: 1741248603
Signature: 5c6b3f0deb891623b2e8bcef577bc4782a067ea8
Content-Type: application/json

{
"agentId": "agent_123",
"userId": "user_001",
"type": 1
}

返回结果

参数类型说明
codeInt返回码,200 表示处理成功。

返回示例

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXX

{
"code": 200
}

错误码

详见 错误码说明