status (문서 번역 진행 상태 확인)

Article Summary

Share feedback

Thanks for sharing your feedback!

개요

Name	Description
X-NCP-APIGW-API-KEY-ID	NCP 앱 등록 시 발급받은 Client ID
X-NCP-APIGW-API-KEY	NCP 앱 등록 시 발급받은 Secret Key

Name	Type	Required	Description
requestId	String	true	Translate API 요청 시 발급받은 Request ID

json 형식으로 리턴

Field Name	Type	Description
data	JSON Object
data.status	String	현재 번역 진행 단계 - WAITING: 번역 대기 - PROGRESS: 진행 중 - COMPLETE: 번역 완료(다운로드 가능) - FAILED: 파일 번역 실패
data.progressPercent	Integer	파일 번역 진행률(%)
data.errCode	String	에러코드. status가 FAILED일 경우 제공
data.errMsg	String	에러 메시지. status가 FAILED일 경우 제공

번역이 완료된 경우

{
    "data": {
        "status": "COMPLETE"
    }
}

번역이 실패한 경우

{
    "data": {
        "status": "FAILED",
        "errCode": "01",
        "errMsg": "Error upload file to server"
    }
}

Error Code	Error Message	Description
01	Error upload file to server	파일 업로드 실패
10	Translated Doc is empty	해당 문서의 글자가 비어있음
11	Translated Docs length exceeded max-len	글자수 제한 초과(30만자)
15	Parsing is not possible	파싱 라이브러리 실패(번역 불가 파일)
16	Unsupported source language	지원하지 않는 source 언어
17	Detected langcode is the same as target langcode	언어 감지 시 source와 target이 동일
18	Language detection failed	언어 감지 실패
50	internal parser error	내부 파서 에러
60	internal server error	내부 서버 에러

{
  "error": {
    "errorCode": "25003",
    "message": "requestId is invalid"
  }
}

HTTP Status Code	Code	Message	Description
401	25003	requestId is invalid	유효하지 않은 request ID로 요청한 경우
404	25006	Not Found	해당 문서 번역의 정보가 없을 경우

$ curl -X GET 'https://naveropenapi.apigw.ntruss.com/doc-trans/v1/status?requestId=20201007_2522985202669'
{"data":{"status":"COMPLETE"}}