文档中心 云点播 普通文件上传

普通文件上传

更新时间:2023-01-30 09:18:09

描述

该接口提供往云视频平台指定的空间上传一个资源文件。若文件大小超过2G,必须使用分片上传。

请求说明

请求方式 Post
接口地址 <uploadUrl>/file/upload

请求参数

接口地址参数说明

参数名 类型 是否必填 描述
uploadUrl string 通过获取视频上传令牌接口得到的上传
地址uploadUrl。

头部说明

参数名 是否必填 描述
Content-Type 内容类型
固定为 multipart/form-data。
<boundary>为Multipart分隔符。
Content-Length 内容总长度,单位:字节(Byte)。

表单参数说明

参数名 类型 是否必填 描述
token text 上传凭证, 通过获取视频上传令牌接口
等接口得到的uploadToken
file file 文件本身

返回参数

<ResponseContent>

返回成功结果

参数名 类型 描述
ResponseContent string <ResponseContent>为如下内容的URL安全的Base64编码字符串:hash=<filehash>

ResponseContent对象的具体字段

参数名 类型 描述
hash string 文件哈希值

返回失败结果

参数名 类型 描述
ResponseContent string 如果请求失败,<ResponseContent>为如下内容的Json字符串:
{ “code”: “<code string>”, “message”: “<message string>” }

ResponseContent对象的具体字段

参数名 类型 描述
code int HTTP请求响应码,参见HTTP响应状态码<返回码>
message string 提示信息

示例

输入示例

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==:eyJzY29wZSI6ImNsb3Vkdi1kb2M6MTYwNjEyL292cHRlc3QvMjAxODAzLzZhYTg0YzkyMDE2MjEwMDA1YmY3OGUzNjAwMDAwMDAwLzZhYTg0YzkyMDE2MjEwMDA1YmY3OGUzNjAwMDAwMDAwLnBkZiIsImRlYWRsaW5lIjoiMjUyNDYyMjQwMDAwMCIsIm92ZXJ3cml0ZSI6MSwiZnNpemVMaW1pdCI6MCwiY2FsbGJhY2tVcmwiOiJodHRwOi8vMTExLjIwNi4yMTkuMjM1L2NhbGxiYWNrL2NhbGxiYWNrIWRvY3VtZW50VXBsb2FkQ2FsbGJhY2suYWN0aW9uIiwiY2FsbGJhY2tCb2R5IjoiJmJ1Y2tldD0kKGJ1Y2tldCkma2V5PSQoa2V5KSZmbmFtZT0kKGZuYW1lKSZmc2l6ZT0kKGZzaXplKSZtaW1lVHlwZT0kKG1pbWVUeXBlKSZ1cmw9JCh1cmwpJmlwPSQoaXApJmNvc3RUaW1lPSQoY29zdFRpbWUpJmRvY3VtZW50SWQ9NmFhODRjOTIwMTYyMTAwMDViZjc4ZTM2MDAwMDAwMDAmY3VzdG9tZXJJZD0xNjA2MTImdXNlck5hbWU9YjNad2RHVnpkQT09JmZpbGVOYW1lPVptbHNaVTVoYldVek1UUnVielE9JmRvY3VtZW50VHlwZT0xJnRhc2tGbGFnPTEmdGFza0RldGFpbElkPTZhYTg0YzkyMDE2MjEwMDA2YzZhMWE5MzAwMDAwMDAwJmZpbGVGdWxsVXJsPU1UWXdOakV5TDI5MmNIUmxjM1F2TWpBeE9EQXpMelpoWVRnMFl6a3lNREUyTWpFd01EQTFZbVkzT0dVek5qQXdNREF3TURBd0x6WmhZVGcwWXpreU1ERTJNakV3TURBMVltWTNPR1V6TmpBd01EQXdNREF3TG5Ca1pnPT0ifQ==

输出示例

例如

返回http状态码为200,返回response为

{“hash”:“FlYd3FAF6hKkJDlzXvkBVNStZhF_”,“response”:"{\“success\”:0}"}

例如

返回http状态码为401, 返回response为

{

“code”: “405”,

“message”: “Token Required”

}

错误码

错误码 返回消息 描述
401 Token Invalid 请求token不正确
401 Token Format Invalid 请求token格式不正确
405 Token Required 需要提供token
500 Internal Server Error 服务器内部出错
401 Token Expired 请求token已过期
400 File Transmission Fail 文件传输失败
401 Upload File Cannot be Empty 未指定上传的文件
401 File Too Large 上传的文件超过大小限制
579 Callback Failed 文件上传成功,回调失败
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!