调用CreateMAURule创建媒体分析(风控)规则。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateMAURule

操作接口名,系统规定参数,取值:CreateMAURule

AppId String ac2g****

应用ID,可通过控制台创建和查询,仅支持传单个ID。

CallBack String Request

媒体分析(风控)检测结果的回调接口,支持Http和Https。CallBack的具体格式描述请参见下文补充说明。

ChannelPrefix String *

媒体分析(风控)的频道匹配前缀,如果成功匹配,该频道就会自动触发风控。

星号(*)代表匹配所有频道。

MauTemplateId Long 1

媒体分析(风控)的模版ID,目前系统只支持系统内置的ID:1,该ID代表进行语音聊天室的反垃圾检测。

UseridPrefix String *

媒体分析(风控)的用户ID匹配前缀,该用户ID是RTC中的用户ID。如果成功匹配,代表会对该用户自动进行风控检测,如果匹配失败,该用户不被检测。

星号(*)代表匹配所有用户。

RTC通过用户传入的callback URl回调用户的内容示例如下。


Request:

POST /mau/callback

Headers:
Authorization:4567

Body
(x-www-form-urlencoded)

"requestId": "a1244c4635e3e34522c2de5da845bce0",
"appId" : "4cf5g1d5bcfc4f3e9e77b280d64****",
"channelId" : "aaa****",
"userId" : "ssRequest:",
"ruleId" : 1,
"label" : "customized",
"suggestion":"block",
"rate":0.80,
"details":[ {
                            "libName":"test",
                            "startTime":"2019-08-19 17:34:44",
                            "endTime":"2019-08-19 17:34:50",
                            "label":"customized",
                             "hintWordsInfo":"[{"context":"敏感词"}]" 
                            "text":"恶心的",
                            "keyword":"恶心"
                        },
                        {
                            "startTime":"2019-08-19 17:36:44",
                            "endTime":"2019-08-19 17:36:44",
                            "label":"ad",
                            "hintWordsInfo":"[{"context":"敏感词"}]" 
                            "text":"微信12345"
                        }
                    ]



Response Body:
{
    "content": {
        "requestId": "2333333333",
   },
    "description": "OK",
    "retCode": 0
} 
请求参数

参数

类型

是否必选

描述

requestId

string

任务请求ID。

appId

string

应用ID。

channelId

string

触发媒体分析(风控)的频道ID。

userId

string

触发媒体分析(风控)的用户ID。

ruleId

int

触发媒体分析(风控)的规则ID。

label

string

检测结果的分类。

suggestion

string

建议动作。pass:内容不违规,建议放行;review:内容可能违规,建议进行人工审核;block:内容违规,建议隔离。

rate

float

结果为该分类的概率,取值范围为0.00~100.00。值越高,表示越有可能属于该分类。

details

Json

语音对应的文本详情。每一句文本对应一个元素,包含一个或者多个元素。

details结构体说明

参数

类型

是否必选

描述

libName

string

如果命中用户自定义关键词,返回关键词所在的词库。

startTime

int

句子开始的时间,单位:秒。

endTime

int

句子结束的时间,单位:秒。

label

string

检测结果的分类,

hintWords

string

语音中包含的文本命中的风险关键词信息,用于提示您违规的原因,可能返回多个命中的关键词。具体结构描述见hintWord。示例值:```"hintWordsInfo":"[{"context":"敏感词"}]"```。

text

string

语音转换成文本的结果。

keyword

string

如果命中用户自定义关键词,返回命中的关键词。

hintWordsInfo结构体说明

参数

类型

是否必选

描述

context

string

语音中文本命中的风险关键词内容。

响应参数:回调返回的内容目前服务器没有进行处理。

参数

类型

长度(bytes)

描述

content

结构体

回调返回的内容。

requestId

string

36

请求ID。

description

string

变长

返回描述。

retCode

int

4

返回的结果码。

返回数据

名称 类型 示例值 描述
RequestId String 760bad53276431c499e30dc36f6b26be

请求ID。

RuleId Long 12

新创建的媒体分析(风控)的规则ID。

示例

请求示例

https://rtc.aliyuncs.comAction=CreateMAURule
&AppId=ac2g****
&ChannelPrefix=*
&UseridPrefix=*
&MauTemplateId=1
&CallBack=Request
&<公共请求参数>

正常返回示例

XML 格式

<CreateMAURuleResponse>
  <RequestId>760bad53276431c499e30dc36f6b26be</RequestId>
  <RuleId>12</RuleId>
</CreateMAURuleResponse>

JSON 格式

{
  "RequestId": "760bad53276431c499e30dc36f6b26be", 
  "RuleId": "12"
}

错误码

访问错误中心查看更多错误码。