Get Video Upload Token
최신 업데이트：2023-01-29 18:04:20
비디오를 업로드하려면 먼저 URL과 자격 증명(토큰)을 가져와야 합니다. 이 API는 URL과 자격 증명을 가져오고 비디오 ID도 생성합니다.
요청 설명
| 아이템 | 설명 |
|---|---|
| 요청 방식 | POST/GET |
| URL | https://api.cloudv.haplat.net/vod/videoManage/getUploadToken |
| 인증 필요 | 예 |
이 인터페이스는OpenAPI를 통해 호출하는 것이 좋습니다. 요청이 성공하면 OpenAPI가 자동으로 코드 조각을 생성합니다.
요청 파라미터
| 파라미터 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| originFileName | string | 예 | 확장자를 포함한 비디오 파일의 이름입니다. 예를 들어, “uploadtest.mp4”. |
| fileId | string | 아니오 | BreakPoint ID로, 최대 32자입니다. 파라미터는 중단점-재개 업로드에 사용됩니다. breakpoint-resume 업로드는 이 파라미터를 지정한 후에만 작동합니다. |
| domain | string | 아니오 | 비디오의 재생 도메인입니다. |
| workflowId | string | 아니오 | 작업 프로세스 ID. Cloud VoD 콘솔, 환경 설정 > 워크플로 > 작업 프로세스 ID에서 워크플로 ID 를 확인할 수 있습니다. 참고: workflowId는 cmd, waterMarkName, transCodeCombineName 및 subtitleId 파라미터를 포함합니다. |
| overwrite | string | 아니오 | 기존 파일을 덮어쓸지 여부: 0–No 1–Yes |
| categoryNames | string | 아니오 | 비디오 카테고리, 상위 카테고리와 하위 카테고리를 한 번에 설정할 수 있습니다. 예를 들어 [{“childName”:“child-category1”,“parentName”:“parent-category1”},{“ childName”:“child-category2”,“parentName”:“parent-category2”}] |
| waterMarkName | string | 아니오 | 워터마크입니다. 업로드되면 비디오에 자동으로 추가됩니다. |
| transCodeCombineName | string | 아니오 | 템플릿된 트랜스코딩의 이름입니다. 지정된 경우 비디오는 업로드 후 트랜스코딩 템플릿에 의해 트랜스코딩됩니다. |
| subtitleId | string | 아니오 | 자막 ID입니다. 지정하면 비디오에 자막이 추가됩니다. |
응답 파라미터
일반적인 응답은 일반적인 응답 을 참조하십시오.
| 파라미터 | 유형 | 설명 |
|---|---|---|
| fileKey | string | 도메인 이름과 상단 슬래시가 없는 상대 경로입니다. 예를 들어 “video/201704/245bbb46f2c1456ae076d2f131949999_1492507971/test.flv”. |
| uploadToken | string | 토큰(credential)은 나중에 업로드할 때 인증에 사용됩니다. |
| uploadUrl | string | 업로드 URL은 비디오 파일을 업로드할 위치를 지정합니다. URL은 나중에 업로드할 때 사용됩니다. |
| videoId | string | 업로드가 완료된 후 비디오에 대한 관련 정보를 조회하는 데 사용할 수 있는 비디오 파일의 ID입니다. |
| httpDnsServe | string | HTTP DNS 서버 주소입니다. |
예시
입력 예
curl -X POST
https://api.cloudv.haplat.net/vod/videoManage/getUploadToken
-H 'content-type: application/x-www-form-urlencoded; charset=utf-8'
-H "Host: api.cloudv.haplat.net"
-H "Authorization: your token"
-H "X-WS-Timestamp: current timestamp"
-H "X-WS-AccessKey: your AccessKey ID"
-d 'originFileName=uploadtest.mp4'
출력 예
{
"code": 200,
"data": {
"speedDomainlUrl": "",
"bucketName": "iven-test-cloudv",
"uploadUrl": "https://upload.cloudv.haplat.net",
"uploadToken": "7e7dae54118c45a6ffd213a*****",
"fileKey": "video/20230129/aea31e8fa8b441eba82ae0d0d900cf3b/555555554o90q7np55560365422q21os_62363dfef1a8446db77f4931a179a676.mp4",
"httpDnsServer": "",
"videoId": "fb67d77901851000ca2d54b900000000"
},
"message": "Operation successfully"
}
## 오류 코드
다음 오류 코드는 비디오 업로드 토큰 가져오기 요청 전용입니다. 일반적인 오류는 [일반적인 응답](https://documents.cdnetworks.com/document/15923/20359) 을 참조하십시오.
| 오류 코드 | 설명 |
| --- | --- |
| 1500 | 파일 이름이 40자를 초과했습니다. |
| 1604 | 파일 MD5 값은 비워 둘 수 없습니다. |
| 1605 | MD5 문자열의 길이가 너무 깁니다. |
| 1606 | 비디오 이름은 비워 둘 수 없습니다. |
| 1607 | 비디오 소스 오류입니다. |
| 1608 | 파라미터 덮어쓰기는 0도 1도 아닙니다. |
| 1609 | 비디오 크기는 음이 아닌 정수만 사용할 수 있습니다. |
| 1610 | 비디오 크기가 제한을 초과했습니다. |이 문서의 내용이 도움이 되었습니까?
예
아니오