Normal Upload

Last update:2023-01-29 17:42:32

Introduction

After obtaining URL and credential(token) of the video, audio or material , you can call this API to upload the video, audio or material to Cloud VoD.

You should use multpart upload if the file size exceeds 2GB.

Request Description

Request Method POST
URL <uploadUrl>/file/upload

The uploadUrl can be obtained from Get Upload Token API.

Request Parameter

Headers

Parameter Required Description
Content-Type Yes For this API, The Content-Type header must be in the multipart/form-data;boundary=xxxxxx format.
The boundary is a string that is randomly generated by the form. No need to specify the boundary yourself.
Content-Length Yes the size of the message body, in bytes.

Form Data

Parameter Type Required Description
token Text Yes The token obtained from Get Upload Token API.
file File Yes The file content.

Response

If the request is successful, you can see the response as following

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

The hash in response is a URL Safe Base64 String which indicates the hash value of the file.
If the request is failed, the response will be as following:

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

Example

Input example

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

Error Code

Here we list some dedicated error codes for this API. If you want more details about the error code, visit Common Responses.

Error Code Message
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
Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!