更新时间: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 | 文件上传成功,回调失败 |