Response_Media Processing_Media Acceleration VoD-Documentation

이 문서는 API 요청에 대한 응답 형식과 반환될 수 있는 HTTP 응답 코드를 설명합니다.

응답 형식

요청이 성공할 경우 서비스는 persistentId를 포함한 JSON 응답을 반환합니다:

{
    "persistentId": "<persistentId>"
}

persistentId는 태스크 추적을 위한 고유 식별자입니다. 기술 지원 요청 시 이 ID를 제공하여 문제 해결을 지원받을 수 있습니다.

중요: persistentId는 요청 제출 성공만을 확인하며, 미디어 처리 완료를 보장하지 않습니다. 태스크 상태 모니터링을 위해 콜백 설정을 통해 상태 알림을 수신할 것을 권장합니다.

요청 실패 시 서비스는 오류 상세 정보가 포함된 JSON 응답을 반환합니다:

{
    "code": "<HTTP_RESPONSE_CODE>",
    "message": "<ERROR_MESSAGE>"
}

필드	설명
`code`	HTTP 상태 코드 (하단 HTTP 상태 코드 참조)
`message`	미디어 처리 실패 원인에 대한 설명

코드	응답 메시지	설명
200	OK	작업이 성공적으로 수행됨
304	Not Modified	파일이 최신 버전으로 수정되지 않음
401	Authorization Required	요청에 Authorization 헤더가 필요함
401	AK/SK Not Found	AccessKey(AK) 또는 AccessKey Secret(SK)를 찾을 수 없음
401	Token Invalid	잘못된 요청 토큰이 제공됨
401	ExpireTime Is Null	ExpireTime 필드가 비어 있음
401	Token Format Invalid	요청 토큰 형식이 잘못됨
401	Bucket Access Denied	요청된 버킷 접근이 거부됨
401	The Persistent File Already Exists	영구 파일이 이미 존재함
404	Bucket Not Found	요청한 버킷이 존재하지 않음
404	File Not Found	요청한 파일을 찾을 수 없음
404	bucketErrorPage	요청한 리소스를 찾을 수 없음
404	Bucket Not Binding Mirror	요청 버킷이 미러 소스에 바인딩되지 않음
405	Token Required	요청에 토큰 파라미터가 필요함
406	File Already Exist	파일이 이미 존재함
406	File Is Busy, Please Retry Later	파일 처리 중. 나중에 재시도 요청
500	Internal Server Error	서버 내부 오류 발생

코드	응답 메시지	설명
401	Bucket Open Image Protect Function, Unable To Get Original Image	이미지 보호 기능 활성화로 원본 이미지 접근 거부됨
401	Non-standard Type Of Op	잘못된 작업 유형 요청
401	Image Process Param Error	이미지 처리 매개변수 오류 발생
404	Watermark Image Url Invalid	워터마크 이미지 URL이 유효하지 않음
404	WaterMark Image Not Found	워터마크 이미지를 찾을 수 없음
579	Get WaterMark Image Fail	워터마크 이미지 다운로드 실패

코드	응답 메시지	설명
400	Tranfer Parameters Error	트랜스코딩 매개변수 오류
401	Ops Invalid	요청의 fops 매개변수가 유효하지 않음
404	Video Persistent Progress Info Not Found	파일 처리 태스크 정보를 찾을 수 없음
579	Json Response	비즈니스 서버 콜백 응답에 예외 발생