You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

请输入
  • 文档首页
    • 企业直播直播质检API 参考回调视频质检消息回调
复制全文
下载 pdf
我的收藏
回调
视频质检消息回调
复制全文
下载 pdf
我的收藏
视频质检消息回调

作用

在视频质检任务的整个生命周期内，当发生以下任一事件时，视频质检服务会向您设置的回调地址发送通知：

  • 视频质检任务的状态发生变化，包括：待机审、机审中、待人审、已完成、任务执行失败
  • 提交是否人审通过消息

前提条件

已调用 CreateVideoTask 接口通过请求参数 CallbackURL 为单个任务配置了接收回调通知的接口地址，或者已联系技术支持配置了全局或项目级回调地址。

详情

在视频质检任务的整个生命周期内，当发生以下任一事件时，视频质检会将任务状态消息以及人审意见消息以 POST 方式提交至您配置的回调地址。

  • 质检任务状态变化，包括待机审、机审中、待人审、已完成、任务执行失败
  • 提交人审是否通过消息

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

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

    POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "TaskId": 123456,
    "TaskName": "video-task-demo",
    "TaskStartTime": 1736323200,
    "AccountId": 10001,
    "ProjectName": "186346****92009",
    "ProjectDisplayName": "Demo 项目",
    "RequestUuid": "InspectionVideoMessageCallback-987654",
    "EventType": "InspectionVideoMessageCallback",
    "Timestamp": 1736323260,
    "Sign": "md5-sign",
    "TaskType": 1,
    "Extra": "{\"biz_id\":\"abc\"}",
    "InspectionMessage": {
        "MessageType": 1,
        "TaskMessageDetail": {
            "SendTime": 1736323260,
            "Status": 2,
            "TaskStatus": 3
        }
    }
}

  • 人审是否通过消息，即 MessageType 取值为 4 时，请求示例如下所示：

    POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "TaskId": 123456,
    "TaskName": "video-task-demo",
    "TaskType": 1,
    "TaskStartTime": 1736323200,
    "AccountId": 10001,
    "ProjectName": "186346****92009",
    "ProjectDisplayName": "Demo 项目",
    "RequestUuid": "InspectionVideoMessageCallback-987656",
    "EventType": "InspectionVideoMessageCallback",
    "Timestamp": 1736323860,
    "Sign": "d02b2cfa2856c1d*******bbfe9411",
    "Extra": "{\"biz_id\":\"abc\"}",
    "InspectionMessage": {
        "MessageType": 4,
        "ManualResultDetail": {
            "MessageId": 17037,
            "ManualComment": "人工审核不通过",
            "UserId": 100001,
            "SendTime": 1736323860,
            "AuditStatus": "REJECTED"
        }
    }
}

超时重试

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

参数

参数

类型

说明

RequestUuid

String

请求回调的唯一标识。

TaskId

Long

视频质检任务 ID。

TaskName

String

视频质检任务名称。

TaskType

Integer

任务类型。固定取值为 1，表示对视频进行质检。

TaskStartTime

Long

视频质检任务开始时间。Unix 时间戳，单位为秒。

ProjectName

String

视频质检任务所属的项目 ID，项目的唯一标识。

ProjectDisplayName

String

视频质检任务所属的项目的展示名称。

AccountId

Long

账号 ID。

EventType

String

回调通知的事件类型，固定取值为 InspectionVideoMessageCallback。

Timestamp

Long

发送回调请求的时间。Unix 时间戳，单位为秒。该时间戳的具体含义根据触发事件的类型而有所不同：

  • 任务状态变更：当回调由任务状态变更（包括：待机审、机审中、待人审、已完成、任务执行失败）触发时，该字段表示状态实际发生变化的时间。
  • 人审是否通过消息：当回调由提交是否人工审核通过消息触发时，该字段表示提交该结论的时间。

Sign

String

校验签名。
完成以下步骤，计算校验签名。

  1. 按照 AccountSecret、AccountId、EventType、Timestamp 的顺序，拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

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

Extra

String

CreateTask 接口传入的业务相关信息。

InspectionMessage

Object of InspectionMessage

视频质检消息详情。

InspectionMessage

参数

类型

说明

MessageType

Integer

消息类型。取值如下：

  • 1：任务状态消息
  • 4：质检报告生成后，人审是否通过消息

TaskMessageDetail

Object of TaskMessageDetail

任务状态消息详情。

说明

仅当 MessageType 取值为 1 时，返回该参数。

ManualResultDetail

Object of ManualResultDetail

人审是否通过详情。

说明

仅当 MessageType 取值为 4 时，返回该参数。

TaskMessageDetail

参数

类型

说明

SendTime

Long

任务状态消息触发时间，即任务状态（包括：待机审、机审中、待人审、已完成、任务执行失败）变更时间。Unix 时间戳，单位为秒。

TaskStatus

Integer

任务状态。取值如下：

  • 1：待机审（当质检任务暂未启动时，返回该值）
  • 2：机审中
  • 3：待人审
  • 4：已完成（人审已完成）
  • 5：任务执行失败

Status（已废弃）

Integer

任务状态。取值如下：

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

注意

该参数已废弃。请参考 TaskStatus 参数。

ManualResultDetail

参数

类型

说明

MessageId

Long

人审消息 ID。

ManualComment

String

人审是否通过或不通过结论的备注。

UserId

Long

审核人用户 ID。
取值为 0 表示主账号。

SendTime

Long

人审结论消息触发时间，即提交人审结论的时间。Unix 时间戳，单位为秒。

AuditStatus

String

对当前任务中的视频内容给出是否审核通过的结论。取值如下：

  • APPROVED：审核通过
  • REJECTED：审核不通过
最近更新时间：2026.09.11 11:46:17
这个页面对您有帮助吗？
有用
有用
无用
无用