Normal Upload
최신 업데이트：2023-01-29 17:42:32
소개
비디오 , 오디오 또는 자료 의 URL과 자격 증명(토큰)을 가져온 후 이 API를 호출하여 비디오, 오디오 또는 자료를 클라우드 VoD에 업로드할 수 있습니다.
파일 크기가 2GB를 초과하면 멀티파트 업로드를 사용해야 합니다.
요청 설명
| 요청 방식 | POST |
|---|---|
| URL | <uploadUrl>/file/upload |
uploadUrl은 업로드 토큰 가져오기 API 에서 가져올 수 있습니다.
요청 파라미터
헤더
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| content-Type | 예 | 이 API의 경우, Content-Type 헤더는 multipart/form-data;boundary=xxxxxx 형식이어야 합니다.경계는 양식에 의해 무작위로 생성되는 문자열입니다. 경계를 직접 지정할 필요가 없습니다. |
| content-length | 예 | 메시지 본문의 크기(바이트)입니다. |
양식 데이터
| 파라미터 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| token | Text | 예 | Get Upload Token API 에서 가져온 토큰입니다. |
| file | 파일 | 예 | 파일 콘텐츠입니다. |
응답
요청이 성공하면 다음과 같은 응답을 볼 수 있습니다
{“hash”:“<hash string>”,“response”:"{\“success\”:0}"}
응답 해시는 파일의 해시 값을 나타내는 URL Safe 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 |