동영상 인코딩 상태 조회

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

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