동적 인제스트 알림

동적 인제스트 API 알림

하나 이상의 콜백 URL을 지정하여 인제스트 프로세스 결과에 대한 알림을 받을 수 있습니다. 지정하는 URL은 POST 요청을 수락할 수 있는 앱용이어야 합니다. 알림은 JSON 형식으로 전송됩니다.

설정

여기 예가 있습니다.

퍼브 아이디 57838016001을 가진 사용자
동적 인제스트를 사용하여 https://s3.amazonaws.com/bucket/mysourcevideo.mp4 에 있는 소스 비디오 파일을 업로드하려고 합니다.
비디오 ID 5199670523001로 카탈로그에 기존 타이틀을 업로드하려고 합니다.
다중 플랫폼 표준 정적 프로파일 사용
각각 https://host1/path1 및 https://host2/path2에 위치한 두 끝점에서 콜백을 수신하려고 합니다.

DI 요청은 다음과 같습니다.

POST 요청

https://ingest.api.brightcove.com/v1/accounts/57838016001/videos/5199670523001/ingest-requests

요청 본문

    {
      "master": {
        "url": "https://s3.amazonaws.com/bucket/mysourcevideo.mp4"
      },
      "profile": "multi-platform-standard-static",
      "callbacks": ["https://host1/path1”, “https://host2/path2”]
    }

샘플 알림

알림은 요청 본문의 알림이 JSON ^{[1] 인 POST 요청으로}전송됩니다. 다음은 일반적인 비디오 인제스트 작업의 전체 알림입니다.

{
      "entity": "default\/audio192",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio192",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio64",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio64",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio96",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio96",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/audio128",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/audio128",
      "language": "en",
      "variant": "main",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "DIGITAL_MASTER",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video450",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video450",
      "bitrate": 451,
      "width": 480,
      "height": 270,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "TITLE",
      "version": "1",
      "action": "PUBLISH",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "thumbnail",
      "entityType": "ASSET",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "poster",
      "entityType": "ASSET",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video900",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video900",
      "bitrate": 901,
      "width": 640,
      "height": 360,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video700",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video700",
      "bitrate": 700,
      "width": 640,
      "height": 360,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video1200",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video1200",
      "bitrate": 1204,
      "width": 960,
      "height": 540,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video1700",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video1700",
      "bitrate": 1703,
      "width": 960,
      "height": 540,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video3500",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video3500",
      "bitrate": 3498,
      "width": 1920,
      "height": 1080,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video2000",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video2000",
      "bitrate": 2000,
      "width": 1280,
      "height": 720,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "default\/video3800",
      "entityType": "DYNAMIC_RENDITION",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "dynamicRenditionId": "default\/video3800",
      "bitrate": 3804,
      "width": 1920,
      "height": 1080,
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

{
      "entity": "5660367449001",
      "entityType": "TITLE",
      "version": "1",
      "action": "CREATE",
      "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
      "videoId": "5660367449001",
      "accountId": "57838016001",
      "status": "SUCCESS"
    }

알림 필드

아이템	설명
`status`	될거야`FAILED`렌디션의 수집 또는 생성이 성공적이지 않은 경우, `SUCCESS`요청이 성공한 경우
`accountId`	계정 ID
`videoId`	비디오 ID
`jobId`	동적 인제스트 요청에 대한 작업 ID
`entity`	엔터티의 이름 또는 제목에 대한 비디오의 비디오 클라우드 ID
`entityType`	보고 된 자산의 종류 - 예를 들면: 제목 (비디오), DIGITAL_MASTER, 에셋 (변환, 캡션 파일 또는 이미지)
`bitrate`	변환에 대한 비트 전송률
`width`	변환의 프레임 폭
`height`	변환의 프레임 높이
`errorMessage`	인제스트가 실패한 이유에 대한 설명
`version`	항상 다음과 같은 문자열`"1"`
`action`	발생한 작업 (예: CREATE)

알림 해석

프로세스 완료를"action": "CREATE"포함하고 이를"status": "SUCCESS"나타내는 알림입니다.

인entityType경우 인제스트된 비디오의 처리가 완료된 것입니다. TITLE
는entityType: TITLE비디오가 활성화된 시간을action: PUBLISH나타냅니다. 즉시 활성화되는 비디오의 경우 시간과 거의 같습니다. CREATE
만약entityType ~이다ASSET , DYNAMIC_RENDITION또는DIGITAL_MASTER , 변환, 이미지, 매니페스트, WebVTT 파일 또는 디지털 마스터가 비디오에 성공적으로 추가된 것입니다.

참고: "status": "SUCCESS"에제목처리가 완료되었음을 나타내지만 반드시 모든 변환이 성공적으로 생성되었음을 의미하지는 않습니다. 비디오의 동적 인제스트가 성공했는지 확인하려면 동적 인제스트 요청의 상태가져오기를 참조하십시오 .

방화벽

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