作用

当脚本预审任务进入待人审、审核完成或执行失败状态时，直播质检服务会将脚本预审任务状态通过此回调发送到您预先设置的回调地址。

前提条件

已调用 CreateScriptPreReview 接口通过请求参数 CallbackURL 为单个脚本预审任务配置了接收回调通知的接口地址。

详情

当脚本预审任务进入以下状态时，直播质检服务会将脚本预审任务状态、发送回调请求的时间、任务 ID 等信息以 POST 方法提交至您在接口中配置的回调地址。请求体为 JSON 格式。

待人审：脚本机审已完成，进入待人审状态时，触发一次脚本预审结果回调；
已完成：人工审核完成，即人工提交了整体的审核结论后，脚本预审进入已完成状态，触发一次脚本预审结果回调；
已失败：脚本机审失败时，触发一次脚本预审结果回调，返回失败原因。

脚本预审状态不同，请求示例也有所不同。

待人审状态的请求示例如下所示：

{
    "RequestUuid": "ScriptPreReviewStatusCallback-10001-3",
    "TaskId": 10001,
    "TaskName": "活动脚本预审",
    "AccountId": 100001,
    "ProjectName": "18743*****299139",
    "EventType": "ScriptPreReviewStatusCallback",
    "Status": "READY_FOR_HUMAN",
    "StatusVersion": 3,
    "Timestamp": 1785480000,
    "Sign": "dd879978a9ef5385e31ff********ca4"
}

任务人审完成状态的请求示例如下所示：

{
    "RequestUuid": "ScriptPreReviewStatusCallback-10001-3",
    "TaskId": 10001,
    "TaskName": "活动脚本预审",
    "AccountId": 100001,
    "ProjectName": "18743*****299139",
    "EventType": "ScriptPreReviewStatusCallback",
    "Status": "SUCCESS",
    "StatusVersion": 3,
    "Timestamp": 1785480000,
    "Sign": "dd879978a9ef5385e31ff********ca4"
}

当脚本预审任务执行失败时，回调请求体中会返回 Failure 字段。请求示例如下所示：

{
    "RequestUuid": "ScriptPreReviewStatusCallback-10001-4",
    "TaskId": 10001,
    "TaskName": "活动脚本预审",
    "AccountId": 100001,
    "ProjectName": "18743*****299139",
    "EventType": "ScriptPreReviewStatusCallback",
    "Status": "FAILED",
    "StatusVersion": 4,
    "Timestamp": 1785480060,
    "Sign": "dd879978a9ef5385e31ff********ca4",
    "Failure": {
        "Code": "ScriptContentTooLongError",
        "Stage": "CREATE",
        "Message": "script content is too long"
    }
}

超时与重试

直播质检的回调服务在发送通知后，如果在 3 秒内没有收到您服务器的 HTTP 状态码 200 OK 响应，即认为通知失败。后续会以 5 秒为间隔重试 2 次。

参数

参数	类型	说明
RequestUuid	String	请求回调的唯一标识。
TaskId	Long	脚本预审任务 ID。
TaskName	String	脚本预审任务名称。
AccountId	Long	账号 ID。
ProjectName	String	预审脚本任务所在的质检任务所属的项目 ID，项目的唯一标识。
EventType	String	回调通知的事件类型，固定取值为 `ScriptPreReviewStatusCallback`。
Status	String	脚本预审任务的状态，取值如下： `READY_FOR_HUMAN`：待人审，表示脚本机审已完成。 `SUCCESS`：已完成，人工审核完成，即审核人提交了整体的审核结论后，任务变为已完成状态。 `FAILED`：任务执行失败。该状态下，将返回 `Failure` 参数说明失败原因。
StatusVersion	Long	任务状态版本号。每次任务状态更新时，版本号从 `1` 开始递增。
Timestamp	Long	发送回调请求的时间，Unix 时间戳，单位为秒。
Sign	String	校验签名，用于验证请求来源的合法性。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountId`、`EventType`、`Timestamp` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。说明请联系技术支持获取鉴权 `AccountSecret`。
Failure	Object of Failure	任务执行失败的信息。说明仅当 `Status` 为 `FAILED` 时，该参数才会返回。

Failure

参数类型说明

参数	类型	说明
Code	String	错误码。取值如下： `ScriptContentTooLongError`：解析出的脚本文本超过上限。单个预审脚本最多支持 20,000 个字符。请检查脚本内容，重新上传。 `ScriptSegmentationFailedError`：预览或分段失败。请联系直播质检技术支持排查。 `ScriptExecutionTimeoutError`：任务执行超时。请重试。请联系直播质检技术支持排查。 `UnknownError`：未知失败。请联系直播质检技术支持排查。
Stage	String	任务执行失败的阶段。取值如下： `PARSE`：文件解析阶段，通常由于上传文件读取、格式解析、内容长度超限或解析分段失败。 `SEGMENT`：任务准备阶段。 `DISPATCH`：任务下发阶段。 `EXECUTE`：任务执行阶段。 `CALLBACK`：回调处理阶段。 `UNKNOWN`：未知失败。
Message	String	具体的错误信息。

Code

String

错误码。取值如下：

ScriptContentTooLongError：解析出的脚本文本超过上限。单个预审脚本最多支持 20,000 个字符。请检查脚本内容，重新上传。
ScriptSegmentationFailedError：预览或分段失败。请联系直播质检技术支持排查。
ScriptExecutionTimeoutError：任务执行超时。请重试。请联系直播质检技术支持排查。
UnknownError：未知失败。请联系直播质检技术支持排查。

Stage

String

任务执行失败的阶段。取值如下：

PARSE：文件解析阶段，通常由于上传文件读取、格式解析、内容长度超限或解析分段失败。
SEGMENT：任务准备阶段。
DISPATCH：任务下发阶段。
EXECUTE：任务执行阶段。
CALLBACK：回调处理阶段。
UNKNOWN：未知失败。

Message String 具体的错误信息。

最近更新时间：2026.08.26 17:36:09

这个页面对您有帮助吗？

有用

无用

企业直播

作用 #

前提条件 #

详情 #

超时与重试 #

参数 #

Failure #

作用

前提条件

详情

超时与重试

参数

Failure