지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    모범 사례: CMS 및 재생 API

    이 항목에서는 카탈로그 API (CMS 및 재생 API) 를 사용하는 모범 사례를 제공합니다.

    서문

    CMS 및 재생 API 모두 비디오 클라우드 비디오 데이터에 대한 액세스를 제공합니다. 이 항목의 목적은 이러한 항목 간의 차이점과 이를 사용하는 모범 사례를 이해하는 데 도움이 되는 것입니다.

    CMS와 재생 API의 차이점

    CMS 및 재생 API는 동일한 기본 비디오 데이터에 액세스합니다. 그러나 특정 상황에서 어떤 것을 사용하는지 결정해야하는 몇 가지 주요 차이점이 있습니다.

    일반적으로 말하면CMS API Video Cloud를 CMS 시스템과 통합하는 것과 같은 백엔드 사용을위한 것입니다. Playback API는 플레이어 또는 비디오 포털 (Brightcove Player catalogplaylist예를 들어 API는 Playback API를 사용합니다.

    아래 표에는 두 API 간의 몇 가지 주요 차이점이 나와 있습니다.

    재생 대 CMS
    아이템 CMS API 재생 API
    작업의 종류 만들기, 읽기, 업데이트, 삭제 읽기 전용 - 재생 API를 사용하여 데이터를 수정할 수 없습니다.
    운영 범위 비디오 데이터의 모든 측면 관리 특정 동영상 또는 재생목록 가져오기 또는 동영상 검색
    인증 일시적인액세스 토큰 영구적 인정책 키
    데이터의 최신 성 캐싱 없음, 항상 최신 최대 20분 동안 캐시됨
    응답 속도 느리게 더 빠름 (캐싱 때문에)
    접속하다 서버 측 전용 (COR 사용 안 함) 서버 또는 클라이언트 측 (COR 사용)
    데이터 비디오 및 재생 목록 요청에는 비디오 소스 URL이 포함되지 않습니다. 이를 가져오려면 두 번째 요청이 필요합니다. 비디오 및 재생 목록 요청에는 비디오 소스 URL이 포함됩니다.

    미디어 URL 사용

    변환, 이미지 및 기타 자산에 대한 URL은 고정되어 있지 않다는 점을 이해하는 것이 중요합니다. 브라이트코브는 미디어 자산의 스토리지를 수시로 재구성하며, 이 경우 특정 자산에 대한 URL이 변경됩니다. 페이지 또는 앱에서 이러한 자산에 대한 하드 코딩된 URL을 사용하는 경우 링크가 어느 시점에서 중단됩니다.

    또한 모든 URL에는TTL콘텐츠 보안상의 이유로 토큰. 즉, URL은 기본적으로 6시간 후에 만료됩니다. 토큰의 수명은 최대 365 일까지 연장 할 수 있습니다. Brightcove 지원에 문의 . 그러나TTL자산이 CDN에 의해 캐시되는 최대 시간을 반영하지만 토큰이 만료되기 전에 URL이 변경되지 않는다는 보장은 없습니다.

    미디어에 대한 링크가 끊어지는 것을 방지하는 가장 좋은 방법은 다음을 사용하여 런타임에 Video Cloud에서 미디어를 검색하는 것입니다. CMS API아니면 그재생 API .

    URL 캐싱

    런타임 API 요청이 옵션이 아닌 경우 하루에 한 번 이상 새로 고쳐지는 로컬 데이터 캐시에서 URL을 가져 오거나 사용자의 TTL (Time-to-Live) 설정 내에서 URL을 가져 오는 것이 좋습니다. TTL토큰 중 더 짧은 것입니다.

    참조 ID 충돌

    이 섹션은 다음에 적용됩니다. CMS API뿐.

    참조 ID의 고유성을 보장하기 위해 는 할당된 비디오에 대한 작업 후 최대 3분 동안 ID를CMS API잠급니다. 이렇게 하면 실패한 요청을 너무 빨리 다시 시도하거나 이전에 할당된 비디오를 삭제한 후 참조 ID를 너무 빨리 다시 사용하려고 할 때 409 오류가 반환될 수 있습니다. 자세한 내용은오류 메시지 참조를참조하십시오.