동영상 인코딩 상태 조회

동영상 인코딩 상태값을 조회합니다.

동영상 파일 업로드 API를 실행하여 얻은 ‘Access Key(원본 키)’와 ‘배포 패키지 ID’ 값이 필요합니다. 배포 패키지는 파일을 인코딩하고, 서비스 할 수 있도록 하는 설정 공간입니다. 업로드 직후 인코딩을 실행하고 조회하기 위해서는 미리 VIDEOPACK 관리자에서 동영상 업로드 폴더와 배포 패키지를 연동하도록 합니다.

인코딩 상태값은 {0~100}까지의 ‘진행률’과 진행 상태를 나타내는 ‘상태값’으로 표시됩니다.

🚧

과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.

비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.

현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.

Request URL

GET https://api.v4.wecandeo.com/info/videopack/encoding/v1/status.json?accessKey={accessKey}&packageId={packageId}

Request Parameters

Parameter Name	Type	Description
accessKey (Required)	String	원본 키 (Access Key)
packageId (Required)	Integer	배포 패키지 ID

Response Example

{
    "encodingStatus": [
        {
            "progress": 100,
            "videoFileKey": "ii8rFc1a4f74ip5dhYQbipiilMWHis7sdvMrpJJQrxGy7VG2qJcY499seUwieie",
            "name": "HLS SD 360P",
            "status": "SERVICE",
            "format": "m3u8",
            "devices": [
                "android"
            ]
        },
        {
            "progress": 100,
            "videoFileKey": "ii8rFc1a4f74ip5dhYQbipiilMWHis7sdvMrpJJQrxGy7VG0THjXBpKgzdQieie",
            "name": "HLS SD 540p",
            "status": "SERVICE",
            "format": "m3u8",
            "devices": [
            ]
        },
        {
            "progress": 100,
            "videoFileKey": "ii8rFc1a4f74ip5dhYQbipiilMWHis7sdvMrpJJQrxGy7VG2Fy2iiipvtPo7wieie",
            "name": "HLS HD 720p",
            "status": "SERVICE",
            "format": "m3u8",
            "devices": [
                "pc",
                "ios"
            ]
        }
    ]
}

Response Data Value

Name	Type	Description
progress	Integer	인코딩 진행률 (0~100)
status	String	- BEING (요청중) - WAIT (대기중) - ENCODING (인코딩) - ERROR (인코딩 실패) - SERVICE (전체 완료. 서비스 가능 상태)
name	String	인코딩 타입 이름
videoFileKey	String	인코딩 파일 키 (Video File Key)
format	String	인코딩 파일 포맷 (Container)
devices	Array	디바이스별 배포 사용 여부 (배포 패키지 설정 값)