批量上传视频至视频库结果回调--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

批量上传视频至视频库结果回调

最近更新时间：2025.10.17 14:38:24首次发布时间：2025.10.17 14:38:24

作用

在通过 UploadMediaByURL 接口批量上传视频至媒资库下的视频库后，企业直播会向您设置的回调地址发送回调消息。

配置方式

完成回调配置。详见回调配置。

详情

完成回调配置后，在调用 UploadMediaByURL 接口成功将视频批量上传至企业直播视频库后，企业直播会将视频的 Vid、上传任务 ID 等数据以 POST 方式提交给您设置的回调地址。
请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": "210*****41",
    "EventType": "UploadMediaByURLFinished",
    "RequestUuid": "UploadMediaByURLFinished-1843****6377",
    "Sign": "298509425******13becab653",
    "Status": "0",
    "SubAccountName": "admin@bytedance.com",
    "TaskId": "c5dcafb9**********67e6896",
    "Timestamp": "1758354072",
    "Vid": "v0c251g*********pdeibq0",
    "VideoName": "视频名称"
}

超时重试

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

参数

参数	类型	说明
AccountId	String	账号 ID。
SubAccountName	String	上传视频的账号。参数值 `admin@bytedance.com` 表示直播间为主账号创建。
EventType	String	回调通知的事件类型，固定取值为 `UploadMediaByURLFinished`。
Timestamp	String	发送回调请求的时间。Unix 时间戳，单位为秒。
Sign	String	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountId`、`EventType`、`TaskId`、`Timestamp`、`Vid` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。说明 `AccountSecret` 的取值可通过控制台获取。详见步骤二：获取鉴权密钥。
RequestUuid	String	请求回调的唯一标识。
Vid	String	视频 Vid。
TaskId	String	通过 UploadMediaByURL 接口批量上传视频后，返回的 `TaskID` 参数。
Status	String	视频上传的结果。`0` 表示上传成功，其它值表示上传失败。
VideoName	String	通过 UploadMediaByURL 接口批量上传视频时，传入的 `Name` 参数。