카테고리 콜백 사용

Classic/VPC 환경에서 이용 가능합니다.

VOD Station은 인코딩 요청 상태 확인을 위한 콜백(Callback) 기능을 사용할 수 있습니다. 콜백 사용 시 VOD Station에서 인코딩 중 상태 변경 이벤트가 발생할 때마다 설정된 notificationUrl로 콜백 메시지가 자동으로 전송됩니다. 다음 API 요청 시 notification에 콜백 URL을 입력하여 콜백을 설정해 주십시오.

참고

콜백 메시지는 encodingOptionId마다 개별 발송됩니다. 예를 들어, 카테고리에 3개의 인코딩 옵션이 설정되어 있고 입력 파일에 대해 인코딩 상태가 변경되었다면 각 인코딩 옵션별로 상태 변경에 대한 콜백을 발송합니다.

콜백 메시지

콜백 메시지에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`categoryId`	Integer	-	카테고리 아이디
`categoryName`	String	-	카테고리 이름
`fileId`	Integer	-	입력 파일 아이디 카테고리 파일 추가 참조 응답 바디의 `id`(파일 인코딩 작업 아이디)
`filePath`	String	-	파일명을 포함한 입력 파일의 버킷 상세 경로 `status`가 `WAITING`(대기)인 경우, 빈 문자열로 전송
`encodingOptionId`	Integer	-	인코딩 옵션 아이디
`outputType`	String	-	출력 타입
`link`	String	-	파일명을 포함한 출력 파일의 HTTP URL 경로 `status`가 `COMPLETE`(완료)인 경우, 표시
`status`	String	-	파일 인코딩 상태 `COMPLETE` \| `WAITING` \| `RUNNING` \| `FAILURE` `COMPLETE`: 완료 `WAITING`: 대기 `RUNNING`: 진행 중 `FAILURE`: 실패

콜백 메시지 예시

콜백 메시지 예시는 다음과 같습니다.

// 작업 대기 (WAITING)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "status": "WAITING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "status": "WAITING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "status": "WAITING"
}

// 작업 진행 중 (RUNNING)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "status": "RUNNING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "status": "RUNNING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "status": "RUNNING"
}

// 작업 완료 (COMPLETE)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "status": "COMPLETE"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "status": "COMPLETE"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",       
  "status": "COMPLETE"
}