동영상 인코딩 상태 조회

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

동영상 업로드 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 (플레이어 주소)