添加消息敏感词
文本消息支持敏感词过滤、替换功能,敏感词替换支持单聊、群聊、聊天室、超级群会话,默认最多设置 50 个敏感词,可以在控制台额外购买个数,设置 15 分钟后生效。
目前支持的敏感词过滤语言包括:中文、英文、日语、德语、俄语、韩语、阿拉伯语。
详见内容审核能力概述中的敏感词过滤规则。
开通服务
即时通讯服务内置敏感词机制,无需开通。注意,敏感词机制默认仅对客户端发送的消息生效,不对通过即时通讯服务端 API 发送的消息生效。如有需要,请开启 Server API 发送消息过滤敏感词。详见配置敏感词服务配置。
请求方法
POST: https://数据中心域名/sensitiveword/add.json
调用频率:每秒钟限 100 次
签名规则:所有服务端 API 请求均需要进行规则校验,详见 API 请求签名。
正文参数
HTTP 请求正文数据格式为 application/x-www-form-urlencoded
,支持以下 HTTP 表单参数:
参数 | 类型 | 必传 | 说明 |
---|---|---|---|
word | String | 是 | 敏感词,最长不超过 32 个字符,格式为汉字、数字、字母。 |
replaceWord | String | 否 | 替换后的词,最长不超过 32 个字符。如未设置,当消息中含有敏感词时,消息将被屏蔽,用户不会收到消息。如设置了,当消息中含有敏感词时,将被替换为指定的词进行发送。 |
请求示例
POST /sensitiveword/add.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded
word=money&replaceWord=****
返回结果
HTTP 响应正文包含具有以下结构的 JSON 对象:
返回值 | 返回类型 | 说明 |
---|---|---|
code | Number | 返回码,200 为正常。 |
返回结果示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200}