质检消息回调--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

质检消息回调

最近更新时间：2025.04.15 20:51:42首次发布时间：2025.04.15 20:51:42

作用

在任务开始到结束的整个生命周期中，当发生以下事件时，直播质检会对所设置的接口地址进行回调通知。

质检任务状态变化，包括任务开始、任务结束和任务执行失败
触发机审违规消息
提交人审处置意见

前提条件

已调用 CreateTask 接口，通过请求参数 CallbackURL 配置回调地址。

详情

在任务开始到结束的整个生命周期中，当发生以下事件时，直播质检会将任务状态消息、机审违规消息，以及人审处置意见消息以 POST 方式提交至您配置的回调地址。

质检任务状态变化，包括任务开始、任务结束和任务执行失败
触发机审违规消息
提交人审处置意见

直播质检提交的消息不同，请求示例也有所不同。

任务状态消息，即 MessageType 取值为 1 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": 200***0872,
    "EventType": "InspectionMessageCallback",
    "Extra": "{\"ActivityId\":123}",
    "InspectionMessage": {
        "MessageType": 1,
        "TaskMessageDetail": {
            "SendTime": 1744558807,
            "Status": 2
        }
    },
    "RequestUuid": "InspectionMessageCallback-18293****5990874",
    "Sign": "f0415f9ae253****d0b9ae17bf476bf1",
    "TaskId": 2047,
    "Timestamp": 1744558807
}

机审违规消息，即 MessageType 取值为 2 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": 200***0872,
    "EventType": "InspectionMessageCallback",
    "Extra": "{\"ActivityId\":123}",
    "InspectionMessage": {
        "MachineMessageDetail": {
            "CustomSensitiveResult": {
                "SensitiveWord": "敏感词",
                "StartTime": 15,
                "Text": "自定义敏感词"
            },
            "RuleId": 243,
            "RuleType": 2,
            "SendTime": 1744609298
        },
        "MessageType": 2
    },
    "RequestUuid": "InspectionMessageCallback-182935****692411",
    "Sign": "05dd8515841****0ab9ad0aef1b78464",
    "TaskId": 2746,
    "Timestamp": 1744609298
}

人审处置意见消息，即 MessageType 取值为 3 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": 200***0872,
    "EventType": "InspectionMessageCallback",
    "Extra": "{\"ActivityId\":123}",
    "InspectionMessage": {
        "ManualMessageDetail": {
            "ManualComment": "直播警告",
            "SendTime": 1744609273,
            "UserId": 0
        },
        "MessageType": 3
    },
    "RequestUuid": "InspectionMessageCallback-182935****165332",
    "Sign": "3be07ada2084****32942e77693f7e8c",
    "TaskId": 2746,
    "Timestamp": 1744609273
}

超时重试

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数

说明

请联系技术支持获取鉴权 AccountSecret。

参数	类型	说明
RequestUuid	String	请求回调的唯一标识。
TaskId	Long	质检任务 ID。
AccountId	Long	账号 ID。
EventType	String	回调通知的事件类型，固定取值为 `InspectionMessageCallback`。
Timestamp	Long	发送回调请求的时间。Unix 时间戳，单位为秒。
Sign	String	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountId`、`EventType`、`Timestamp` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。
Extra	String	CreateTask 接口传入的业务相关信息。
InspectionMessage	InspectionMessage	质检消息详情。

InspectionMessage

参数	类型	说明
MessageType	Integer	消息类型。取值如下： `1`：任务状态消息 `2`：机审违规消息 `3`：人审处置意见消息
TaskMessageDetail	Object of TaskMessageDetail	任务状态消息详情。说明仅当 `MessageType` 取值为 `1` 时，返回该参数。
MachineMessageDetail	Object of MachineMessageDetail	机审违规消息详情。说明仅当 `MessageType` 取值为 `2` 时，返回该参数。
ManualMessageDetail	Object of ManualMessageDetail	人审处置意见消息详情。说明仅当 `MessageType` 取值为 `3` 时，返回该参数。

TaskMessageDetail

参数	类型	说明
SendTime	Long	任务状态消息触发时间，即任务状态变更时间。Unix 时间戳，单位为秒。
Status	Integer	任务状态。取值如下： `1`：开始，即机审中状态（质检任务创建成功后，即进入机审中状态） `2`：成功，即待人审状态 `3`：任务执行失败

参数

类型

说明

SendTime

Long

任务状态消息触发时间，即任务状态变更时间。Unix 时间戳，单位为秒。

Status

Integer

任务状态。取值如下：

1：开始，即机审中状态（质检任务创建成功后，即进入机审中状态）
2：成功，即待人审状态
3：任务执行失败

MachineMessageDetail

参数	类型	说明
RuleId	Long	规则 ID。
RuleType	Integer	规则类型。取值如下： `1`：系统敏感词 `2`：自定义敏感词
SendTime	Long	机审消息触发时间，即机审触发指定规则，判定机审不通过的时间。Unix 时间戳，单位为秒。
CustomSensitiveResult	Object of CustomSensitiveResult	自定义敏感词的检测结果。说明仅当`RuleType` 取值为 `2` 时，返回该参数。
SystemSensitiveResult	Object of SystemSensitiveResult	系统敏感词的检测结果。说明仅当`RuleType` 取值为 `1` 时，返回该参数。

CustomSensitiveResult

参数	类型	说明
SensitiveWord	String	命中的敏感词。
Text	String	包含敏感词的语音识别文本内容。
StartTime	Long	语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始，语音识别文本出现在 10:01:00，则参数取值为 `60`。

SystemSensitiveResult

参数	类型	说明
Text	String	包含敏感词的语音识别文本内容。
StartTime	Long	语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始，语音识别文本出现在 10:01:00，则参数取值为 `60`。

ManualMessageDetail

参数	类型	说明
ManualComment	String	人审处置意见。
UserId	Long	审核人用户 ID。取值为 `0` 表示主账号。
SendTime	Long	人审处置意见消息触发时间，即提交人审处置意见的时间。Unix 时间戳，单位为秒。