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

    CMS API 알림

    이 주제에서는 CMS API 알림. 그만큼 CMS API 계정 사용자가 작성 했든 또는 동영상을 변경했는지에 관계없이 계정의 동영상에 대한 변경 사항에 대한 알림을 제공합니다. Video Cloud 시스템.

    개요

    다음과 같은 경우 알림을받을 수 있습니다. video-change 비디오 라이브러리에서 이벤트가 발생합니다. 알림은 지정한 URL로 전송되며, 처리 할 수있는 애플리케이션을 가리켜 야합니다. HTTP POST 요청.

    인증

    에 대한 모든 요청과 마찬가지로 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 or events 필드가 요청 본문에서 누락되었습니다.
    • 그리고, events 필드 값이 목록 (배열)이 아닙니다.
    • 정의 된 구독이 이미 있습니다.
    • 이 일정에 10 구독이 이미 있습니다.

    알림 실패

    통지 시스템은 4xx or 5xx 다시 시도 가능한 실패로 고객 서버에서 반환. 실패한 콜백은 20 번까지 재 시도되며 후속 콜백 간에는 기하 급수적으로 지연이 발생합니다. 처음 몇 번의 재시도는 초기 콜백 시도 후 몇 분 이내에 발생합니다. 콜백이 계속 실패하고 20th 재시도에 도달하면 재시도 지연이 며칠이 걸릴 것입니다.

    방화벽

    조직에서 방화벽을 통해 들어오는 트래픽 소스와 관련된 엄격한 정책이있는 경우 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}
            
            

    A GET 요청은 구독을 검색합니다. 에이 DELETE 요청은 구독을 삭제합니다. 현재 구독을 업데이트 할 수 없습니다. 구독을 수정하려면 구독을 삭제하고 새 구독을 만들어야합니다.

    알림을 실행시키는 것은 무엇입니까?

    video-change 이벤트는 비디오 메타 데이터가 변경되면 트리거됩니다. 여기에는 Studio에서 변경 한 비디오 또는 CMS API 쓰기 메소드. 트리거 할 시스템 이벤트도 있습니다. video-change 이벤트.

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

    • 동영상이 생성되었습니다.
    • 동영상 또는 저작물 파일의 섭취가 시작됩니다.
    • 동영상 또는 저작물 파일의 섭취가 완료되었습니다.
    • 새 렌 디션의 인코딩이 완료됩니다.
    • 포스터 이미지가 생성됩니다.
    • 미리보기 이미지가 생성됩니다.
    • 동영상이 삭제되었습니다.
    • 비디오 메타 데이터가 변경되었습니다 (시스템 또는 사용자에 의해)

    노트

    비디오를 다시 트랜스 코딩해도 video-change 결과 렌 디션 세트가 다른 경우가 아니면

    비디오가 삭제 된 후에 발생하는 시스템 이벤트가 있으므로 비디오를 삭제 한 후 비디오에 대한 알림을받습니다.

    어떤 것 지원 a를 방아쇠하다 video-change 이벤트는 동영상 메타 데이터를 변경하지 않는 동영상 애셋의 변경 사항입니다. 예를 들어, 원격 텍스트 트랙 파일이나 이미지를 바꾸지 만 비디오 메타 데이터에 기록 된 URL은 동일하게 유지됩니다 video-change 이벤트가 발생하고 알림이 전송되지 않습니다.


    12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지