Normal Upload

更新时间:2023-01-29 17:42:32

介绍

获取视频音频素材的URL和凭证(token)后,可以调用该接口将视频、音频或素材上传至云点播。

如果文件大小超过 2GB,则应使用分块上传。

请求说明

请求方法 POST
请求地址 <uploadUrl>/file/upload

uploadUrl 可以从Get Upload Token API 获取

请求参数

请求头

参数名 必填 描述
Content-Type 对于此 API,内容类型固定为multipart/form-data;boundary=xxxxxx
其中boundary是由表单随机生成的字符串。您无需自己指定boundary的值。
Content-Length 内容总长度,单位:字节(Byte)。

表单参数

参数名 类型 必填 描述
token Text Get Upload Token API 获取的令牌。
file File 文件内容。

响应参数

如果请求成功,可以看到如下响应

{“hash”:“<hash string>”,“response”:"{\“success\”:0}"}

返回结果中的hash是一个 URL 安全 Base64 字符串,是文件的哈希值。
如果请求失败,响应将如下所示:

{ "code": "<error code>", "message": "<message>" }

例子

输入示例

curl -X POST \ https://upload.cloudv.haplat.net/file/upload \ -H 'cache-control: no-cache' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -F file=@1b095d2c66034d6bb3d74fa4e306bf4c20171122162359.jpeg \ -F token=7e7dae54118c45a6ffd213a18c9d4847b51a73f1:M2Q4ODczNzU0YjY2NzQ1YTEwNzZmOGNlODQ3ZDZiOWE3MDk0NTlhNQ==:==

错误代码

这里我们列出了该 API 的一些专用错误代码。如果您想了解有关错误代码的更多详细信息,请访问常见响应

错误代码 信息
400 File Transmission Fail
401 Token Invalid
401 Token Format Invalid
401 Token Expired
401 Upload File Cannot be Empty
401 File Too Large
405 Token Required
500 Internal Server Error
579 Callback Failed
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!