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

동영상 업로드 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	Integer
status	String	BEING (요청) WAIT (대기중) REQUEST_ERR (요청 오류) FILE_NOTFOUND (파일 없음) FILEOVER (용량 초과) ENCODEING (인코딩) ENCODEERR (파일 오류) ENCODEEND (파일 인코딩 완료) 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 (플레이어 주소)