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

Prev Next

개요

  • 문서파일 번역 진행상태 확인용 API (GET)
  • 현재 처리단계 및 진행률(%)에 대한 정보 리턴

Header

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

Parameter

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

Response

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 언어 감지 실패
36 PDF Resolution Error 지원 해상도 초과
37 the target language is the same as the source language 번역언어와 문서 언어가 동일
38 invalid glossary key glossayKey가 유효하지 않음
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 Example

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