이 문서는 Cloud VoD API의 새 버전을 사용하는 방법에 대한 자세한 가이드를 제공합니다. 새 API는 OpenAPI를 통해 호출되며, 쉬운 테스트와 API 호출이 가능합니다. OpenAPI는 귀하의 요청을 처리하고 입력을 기반으로 다양한 언어의 예제 코드를 생성합니다.
이전 버전의 API를 사용하고 있다면 걱정할 필요가 없습니다. 우리는 계속해서 이전 Cloud VoD API를 지원할 것입니다. 그러나 새로운 사용자에게는 새 버전을 채택할 것을 강력히 권장합니다. 새 API에서는 API 호출 중 발생하는 문제를 더 잘 추적하고 해결하기 위해 각 요청/작업에 고유한 ID를 할당합니다. 이 ID는 “x-cnc-request-id” 필드 아래의 응답 헤더에서 클라이언트에게 반환됩니다.
중요: 지속적인 기능 업데이트로 인해 API 응답에 새로운 JSON 또는 XML 필드가 추가될 수 있습니다. 개발자는 문자열 파싱 대신 JSON과 XML 표준에 따라 이러한 필드를 파싱해야 합니다. 또한, 고객 계정 당 API 호출 빈도를 기본적으로 5분당 300개 요청으로 제한합니다. 개별 API에 대한 권장 속도는 5분당 30회 호출입니다. 귀하의 필요가 이러한 한도를 초과하는 경우, 고객 지원에 문의하십시오.
사용하기 전에
모든 API 호출은 인증이 필요하며, 요청에 토큰을 포함해야 합니다. Cloud VoD API를 사용하기 전에, Cloud VoD 서비스를 활성화했고 API 인증을 위한 AccessKey Secret을 얻었는지 확인하십시오. AccessKey ID와 AccessKey Secret을 얻으려면 콘솔로 이동하여 보안 설정 -> AccessKey 관리 -> 표시로 이동하십시오. 이 자격 증명은 API 액세스를 인증하기 위해 사용되므로 AccessKey ID와 AccessKey Secret을 안전하게 저장하십시오.
API 개요
자산 업로드
비디오 관리
| API |
설명 |
| getVideoList |
업로드된 비디오 목록과 그 세부 사항을 얻습니다. 세부 사항에는 업로드 시간, 비디오 이름, 비디오 ID, 비디오 상태 등이 포함됩니다. |
| videoEdit |
비디오의 기본 정보를 편집합니다. 이름, 설명, 카테고리, 발행 도메인 등을 수정할 수 있습니다. |
| videoBlock |
업로드된 비디오를 비활성화 또는 차단합니다. 비활성화되면 비디오는 더 이상 볼 수 없습니다. |
| videoEnable |
이전에 비활성화된 비디오를 다시 활성화합니다. |
| deleteVideo |
업로드된 비디오를 삭제합니다. |
오디오 관리
| API |
설명 |
| getAudioList |
업로드된 오디오 목록과 그 세부 사항을 얻습니다. 세부 사항에는 업로드 시간, 이름, ID, 상태 등이 포함됩니다. |
| editAudio |
오디오의 기본 정보를 편집합니다. 이름, 설명, 카테고리, 발행 도메인 등을 수정할 수 있습니다. |
| deleteAudio |
업로드된 오디오를 삭제합니다. |
자료 관리
카테고리 관리
비디오 처리
