logo
当前页

CreateUploadTask

POST

https://cloud-player-api.zego.im/

创建一个上传任务,将 URL 在线资源上传到 OSS。上传之后同区域的云播放器集群可以通过内网拉流地址获取播放资源,保证资源传输过程的稳定性。

说明

此功能为增值服务,如需使用,请联系 ZEGO 商务人员开通。

说明

对于单个 AppID 而言,ZEGO 服务端最多同时可处理 10 上传任务(包含上传中和等待中),如需调高上限,请联系 ZEGO 技术支持修改。

说明
调用频率限制:20 次/秒

Request

Query Parameters

    Action string必填

    可选值: [CreateUploadTask]

    接口原型参数

    https://cloud-player-api.zego.im?Action=CreateUploadTask

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

Body

required
    Title string必填

    可选值: <= 100 characters

    文件名称,长度上限为 100B,文件后缀(支持 .mp3.mp4.flv.wav.aac.flac)需保留且正确,否则可能导致播放失败。

    注意

    请勿使用相同文件名称。如果多个文件的 Title 相同,它们会互相替代,只保留最后上传的文件,但是,新文件可能会继承旧文件的过期时间。

    StreamUrl string必填

    可选值: <= 1024 characters

    媒体资源的地址,必须是有效的 HTTP/HTTPS 地址,且长度在 1024 字节以内,文件大小上限为 5GB。

    RetentionDays number

    可选值: >= 1 and <= 7

    默认值: 3

    资源有效时长,单位为天。有效取值范围为 [1, 7],(默认值:3),如果您需要提高上限,请联系 ZEGO 技术支持处理。

    ContentMd5 string

    ContentMd5 是通过 MD5 算法对文件进行计算生成的哈希值,然后经过 Base64 编码得到的结果,用于验证文件在上传过程中是否保持完整性。

    如果您在上传时提供了 ContentMd5 参数,ZEGO 服务端会通过 OSS 计算文件的 ContentMd5 并与您提供的值进行比对。若两者不一致,上传将失败,表明文件可能被篡改或损坏。

    为确保文件的完整性和安全性,强烈建议在上传文件时传入 ContentMd5 参数。

    以下是使用 PHP 生成 ContentMd5 的示例:

    function calculateMD5($content) {
        return base64_encode(md5($content, true));
    }
    

Responses

OK
Schema
    Code number

    返回码。

    以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码

    返回码说明处理建议
    0成功。-
    100000004签名过期。请重新生成签名。
    100000005签名错误。请确认生成签名的参数是否正确。
    350006001接口请求频率超过上限。请确认对应接口的 QPS 限制,降低请求频率。
    350006002网关校验失败。请联系 ZEGO 技术支持处理。
    350006003无效的输入参数。请根据 Message 提示,调整对应参数的取值。
    350006006服务未开通。请联系 ZEGO 技术支持,开通服务权限。
    350010000系统错误。请联系 ZEGO 技术支持处理。
    Message string

    操作结果描述。

    RequestId string

    请求 ID。

    Data object
    响应对象。
    UploadTaskId string

    上传任务 ID。

    CreateTime number

    文件上传任务创建成功的 Unix 时间戳,单位:秒。

上一篇

查询云端播放器列表

下一篇

取消上传任务

当前页

返回到顶部