VOD Station은 인코딩 요청 상태 확인을 위한 Callback 기능을 제공합니다.
Callback 기능은 카테고리 생성 또는 카테고리 파일 추가시 notificationUrl 필드에 Callback Endpoint 를 입력하여 사용할 수 있습니다.
Callback 발송 데이터
notificationUrl을 등록하면 VOD Station 에서 인코딩 중 상태 변경 이벤트가 발생할 때마다 설정된 notificationUrl 로 아래와 같은 형태의 데이터가 전송됩니다. (HTTP POST 요청)
Callback 발송은 encodingOptionId 마다 개별 발송됩니다.
(예시: 카테고리에 3개의 encodingOption 이 설정되어 있다면, 각 encodingOption 별 상태 변경에 대한 콜백 발송)
참고
인코딩 상태에 따른 입력 파일 경로는 status 필드의 값이 WAITING일 때, filaPath 필드 값이 빈 문자열로 전송됩니다.
| 필드명 | 타입 | 설명 |
|---|---|---|
| categoryId | Integer | 인코딩 카테고리 ID |
| categoryName | String | 인코딩 카테고리 이름 |
| encodingOptionId | Integer | 인코딩 옵션 ID |
| fileId | Integer | 입력 파일 ID |
| filePath | String | 입력 파일 경로 |
| outputType | String | 출력 인코딩 옵션 이름 |
| status | String | 입력 파일의 인코딩 상태 |
Callback 발송 HTTP Body 예시
{
"categoryId":10268,
"categoryName":"callback-test",
"encodingOptionId":3,
"fileId":10808,
"filePath":"/.../Guide720_AVC_HD_1Pass_30fps.mp4",
"outputType":"AVC_HD_1Pass_30fps",
"status":"RUNNING"
}