更新时间: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 |