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

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

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

과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
또한 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트될 수 있습니다.

Request URL 

GET https://api.wecandeo.com/web/encoding/status.json?key={API key}&access_key={access_key}&pkg={package ID}

Request Parameters

Parameter Name Type Description
key (Required) String API 키
access_key (Required) String 원본 키 (Original Key – Video Access Key_Level 1)
pkg (Required) Integer 배포 패키지 ID

Response Example

{
    encodingStatus: {
        errorInfo: {
            errorCode: “None”,
            errorMessage: “”
        },
        statusList: [{
                process: 100,
                status: “SERVICE”,
                name: “SD 360P (PC / MOBILE)”,
                access_key: “BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLGBYMhGdBvL4MOwkBTzaHc1GRipnLmItlKxisQucqJWZzwieie”,
                format: “mp4”,
                devices: [“ios”, “android”]
            },
            {
                process: 100,
                status: “SERVICE”,
                name: “SD 480P (PC / MOBILE)”,
                access_key: “BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLGBYMhGdBvL4MOwkBTzaHc1GRipnLmItlJZkeE1K8xFygieie”,
                format: “mp4”,
                devices: [“pc”]
            },
            {
                process: 100,
                status: “SERVICE”,
                name: “HD 540P (PC / MOBILE)”,
                access_key: “BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLGBYMhGdBvL4MOwkBTzaHc1GRipnLmItlIdNiiCI2AEipGwieie”,
                format: “mp4”,
                devices: []
            }
        ],
        videoPublishInfo: {
            videoUrl: “https://api.wecandeo.com/video?k=BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLuipP30bVKv7gieie”,
            videoKey: “BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLuipP30bVKv7gieie”,
            videoPageUrl: “https://play.wecandeo.com/video/v/?key=BOKNS9AQWrFDVnV6rhC2Ca0gpF3OhwV3hiseZ8pv2OmLuipP30bVKv7gieie”
        }
    }
}




Response Data Value

Name Type Description
process Integer 인코딩 진행율 0~100(%)
status String – BEING (요청중)
– WAIT (대기중)
– REQUEST_ERR (요청 오류)
– FILE_NOTFOUND (파일 없음)
– FILEOVER (용량 초과)
– ENCODEING (인코딩)
– ENCODEERR (파일 오류)
– ENCODEED (인코딩 완료)
– BYPASSFILECHK (바이패스 파일 체크)
– BYPASSFILEERR (바이패스 파일 오류)
– BYPASSING (바이패스 처리 중)
– BYPASSERR (바이패스 오류)
– BYPASSEND (바이패스 완료)
– AQUAPACKING (아쿠아 팩킹 중)
– AQUAERR (아쿠아 팩킹 에러)
– AQUAEND (아쿠아 팩킹 완료)
– PALLYCONPACKING (팰리컨 팩킹 중)
– PALLYCONERR (팰리컨 팩킹 에러)
– PALLYCONEND (팰리컨 팩킹 완료)
– PREPARING (배포 중)
– SERVICING_ERR (배포 실패)
– SERVER_ERR (서버 오류)
– SERVICE (전체 완료. 서비스 가능 상태)
name String 인코딩 타입 이름
access_key String 인코딩 파일 키 (File Key – Video Access_Key Level 3)
format String 인코딩 파일 포맷(콘테이너)
devices Array 디바이스별 배포 사용 여부(배포 패키지 설정 값)
videoKey String 동영상 키 (Video Key – Video Access Key_Level 2)
videoUrl String 동영상 URL (Video Url – Video File_Url Level 2)
videoPageUrl String 동영상 Play URL (플레이어 주소)