status (문서 번역 진행 상태 확인)
- 인쇄
- PDF
status (문서 번역 진행 상태 확인)
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
- 문서파일 번역 진행상태 확인용 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 | 번역언어와 문서 언어가 동일 |
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://naveropenapi.apigw.gov-ntruss.com/doc-trans/v1/status?requestId=20201007_2522985202669'
{"data":{"status":"COMPLETE"}}
이 문서가 도움이 되었습니까?