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

    CMS API 알림

    이 항목에서는 다음에 대해 학습합니다. CMS API알림. 그만큼CMS API계정 사용자 또는 Video Cloud 시스템에 의해 변경된 계정의 비디오에 대한 알림을 제공합니다.

    개요

    다음과 같은 경우 알림을받을 수 있습니다. video-change이벤트는 비디오 라이브러리에서 발생합니다. 알림은 지정한 URL로 전송되며 처리 할 수있는 응용 프로그램을 가리켜 야합니다. HTTPPOST요청.

    인증

    CMS API에 대한 모든 요청과 마찬가지로 알림 구독 설정 또는 나열 요청은 다음을 사용하여 인증되어야합니다. 액세스 토큰 . 액세스 토큰을 가져 오는 데 사용되는 클라이언트 자격 증명에는 다음에 대한 권한이 있어야합니다. video-cloud/notifications/all ( CMS->Notifications당신이 사용한다면 Studio UI자격 증명을 생성합니다.)

    설정

    알림을받을 엔드 포인트를 최대 10 개까지 지정할 수 있습니다. POST에 요청https://cms.api.brightcove.com/v1/accounts/{account_id}/subscriptions다음과 같이 요청 본문에 JSON을 포함합니다.

            {
            "endpoint":"http://solutions.brightcove.com/bcls/di-api/di-callbacks.php",
            "events":["video-change"]
            }
            
            

    알림은 JSON 형식으로 전송됩니다. 예를 들면 다음과 같습니다.

            {"timestamp":1423840514446,
            "account_id":"775205503001",
            "event":"video-change",
            "video":"4020894387001",
            "version":26}
            
            

    알림 필드

    아이템 설명
    timestamp 이벤트가 발생한 시간Epoch밀리 초
    account_id 그만큼Video Cloud계정 ID
    event 이벤트 유형-현재는 항상video-change
    video 비디오 ID
    version 비디오 버전-각 변경 이벤트 세트는 비디오 버전을 증가시킵니다. 예를 들어, 새로운 변환 세트를 생성하면 일련의 변경 이벤트가 구성됩니다.

    구독 생성 요청은HTTP 422다음 조건에 대한 오류 응답 :

    • 그만큼endpoint또는events요청 본문에서 필드가 누락되었습니다.
    • 그만큼events필드 값이 목록 (배열)이 아닙니다.
    • 정의 된 구독이 이미 있습니다.
    • 이 이벤트에 대한 구독이 이미 10 개 있습니다.

    알림 실패

    알림 시스템은4xx또는5xx재시도 가능 실패로 고객 서버에서 반환됩니다. 실패한 콜백은 최대 20 회까지 다시 시도되며 후속 콜백 간의 지연이 기하 급수적으로 증가합니다. 처음 몇 번의 재시도는 초기 콜백 시도 후 몇 분 이내에 발생합니다. 콜백이 계속 실패하고 20 번째 재시도로 나아갈 경우 재시도 지연은 며칠이 걸릴 것입니다.

    방화벽

    조직에서 방화벽을 통해 수신되는 트래픽 소스에 대한 엄격한 정책이있는 경우 AWS us-east-1 / Virginia IP를 허용합니다. 이는 변경될 수 있으므로 모든 AWS IP를 허용 목록에 추가해야 합니다. 보다 http://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html자세한 내용은.

    알림 구독을위한 끝점

            /accounts/{account_id}/subscriptions
            
            

    새 구독 만들기

    새 구독을 생성하려면POST알림을 전달하려는 엔드 포인트를 포함하는 요청 본문이있는 요청 및video-change의 단일 항목으로events정렬:

            { "endpoint": "http://solutions.brightcove.com:9002", "events": [ "video-change" ] }
            
            

    구독 목록 가져 오기

    모든 구독 목록을 얻으려면GET구독 엔드 포인트에 대한 요청입니다.

    단일 구독 가져 오기 또는 삭제

    다음 끝점을 사용하여 단일 구독을 가져 오거나 삭제합니다.

    끝점

            /accounts/{account_id}/subscriptions/{subscription_id}
            
            

    GET요청은 구독을 검색합니다. ㅏDELETE요청하면 구독이 삭제됩니다. 지금은 구독을 업데이트 할 수 없습니다. 구독을 수정하려면 구독을 삭제하고 새로 만들어야합니다.

    알림을 트리거하는 것은 무엇입니까?

    video-change이벤트는 비디오 메타 데이터의 변경에 의해 트리거됩니다. 여기에는 Studio에서 또는CMS API쓰기 방법. 트리거 할 시스템 이벤트도 있습니다. video-change이벤트.

    이벤트를 트리거하는 변경 사항은 다음과 같습니다.

    • 비디오가 생성됩니다.
    • 비디오 또는 자산 파일 수집 시작
    • 비디오 또는 자산 파일 수집이 완료되었습니다.
    • 새 변환의 인코딩이 완료됩니다.
    • 포스터 이미지가 생성됩니다.
    • 썸네일 이미지가 생성됩니다.
    • 비디오가 삭제되었습니다
    • 비디오 메타 데이터가 변경됨 (시스템 또는 사용자에 의해)

    참고

    비디오를 다시 트랜스 코딩해도video-change결과 변환 세트가 다른 경우를 제외하고 이벤트입니다.

    동영상이 삭제 된 후 발생하는 시스템 이벤트가 있으므로 삭제 후 알림을 받게됩니다.

    무엇을아니트리거video-change이벤트는 비디오 메타 데이터를 변경하지 않는 비디오 자산에 대한 변경입니다. 예를 들어 원격 텍스트 트랙 파일 또는 이미지를 교체했지만 비디오 메타 데이터에 기록 된 URL은 그대로 유지되는 경우video-change이벤트가 발생하고 알림이 전송되지 않습니다.