You need to enable JavaScript to run this app.
导航

URL 批量拉取上传完成

最近更新时间2023.12.29 16:57:56

首次发布时间2021.02.23 10:42:38

本文为您介绍 URL 批量拉取上传完成事件的类型、说明、内容和回调示例等。

事件类型

FileUploadByUrlComplete

事件说明

如果您的空间配置了 URL 批量上传完成回调通知,通过 URL 批量拉取上传执行的每个 URL 上传完成后,您将收到事件回调通知。配置方法详见 事件通知概览。关联接口:URL批量拉取上传

事件内容

参数类型描述
RequestIdString请求的唯一 ID
VersionString回调版本
EventTypeString回调事件名称 FileUploadByUrlComplete
EventTimeString事件产生的时间
DataData视频具体信息

Data

参数类型描述
CodeString错误码
MessageString错误具体信息
JobIdString任务 ID
SourceUrlString源视频 URL 地址
CallbackArgsString回调透传参数
VidString视频 ID
SpaceNameString空间名称
SourceInfoSourceInfo源视频信息
PosterUriString视频封面图存放位置

SourceInfo

参数类型描述
StoreUriString文件存放位置
HeightInteger视频高度
WidthInteger视频宽度
DurationFloat视频时长
BitrateInteger码率
Md5StringMd5 值
FormatString视频格式
SizeInteger视频大小
FileNameString文件路径

回调示例

上传成功回调示例

{
    "RequestId": "2020072711510***05207114001CC4",
    "Version": "1.0",
    "EventType": "FileUploadByUrlComplete",
    "EventTime": "2020-07-27T11:04:05Z",
    "Data": {
        "Code": "Success",
        "Message": "file upload success",
        "JobId": "f08d26b0e963***9f208c1ca79cfd5d",
        "SourceUrl": "http://xxx.mp4",
        "CallbackArgs": "item id",
        "Vid": "v02af6e500***3pbvh148u6ung0",
        "SpaceName": "ecqc-live",
        "SourceInfo": {
            "StoreUri": "",
            "Md5": "",
            "Width": 544,
            "Height": 960,
            "Duration": 143.98,
            "Bitrate": 0,
            "Format": "mp4",
            "FileName": "e4c13e5505874e***4b1e74c8616",
            "Size": 1024,
        },
        "PosterUri": "tos-cn-v-f4fc******505874e58908b94b1e74c8616"
    }
}

上传失败回调示例

{
    "RequestId":"202206161501***216519620B65717",
    "Version":"1.0",
    "EventTime":"2022-06-16T15:02:08Z",
    "EventType":"FileUploadByUrlComplete",
    "Data":{
        "Code":"DownloadFailed.UrlDownloadFail",
        "Message":"404 Not Found",
        "JobId":"3f91953e99***9e9044ab8eb98bd8",
        "SourceUrl":"https://stream7.iqilu.com/******transcode/202002/18/ooooooooooooooo.mp4",
        "CallbackArgs":"",
        "Vid":"",
        "SpaceName":"vod-v2-test",
        "SourceInfo":{
            "StoreUri":"",
            "Width":0,
            "Height":0,
            "FileName": "e4c13e5505874e***4b1e74c8616",
            "FileType":""
        },
        "PosterUri":"",
        "OptionInfo":{
            "TemplateId":""
        }
    }
}

回调错误码

错误码说明
Success上传成功
InvalidParameter.InvalidParam入参错误,如 url 传的不是 http 开头,传了个随机字符串等。
DownloadFailed.UrlDownloadFail下载视频报错。可能是资源不存在或提供资源的服务异常或网络异常。
CheckError.Md5MissMatch入参传入的 Md5 与实际的 Md5 不匹配。
UploadFailed.UrlUploadFailed上传时发生错误,一般为后台异常。
InternalError.UrlUploadError服务端上传内部错误,一般为依赖服务异常。
OperationDenied.DenyOverwriteUpload禁止不同文件以相同 FileName 覆盖上传。