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

    동적 인제스트 알림

    이 항목에서는 동적 인제스트 API를 사용하여 제출된 동적 배달 수집 작업에 대한 알림에 대해 알아봅니다.

    동적 인제스트 API 알림

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

    설정

    여기 예가 있습니다.

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

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

    POST 요청

    요청 본문

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

    샘플 알림

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

    {
          "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 파일 또는 디지털 마스터가 비디오에 성공적으로 추가되었습니다.