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

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

    • PDF

    기사 요약

    개요

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

    Header

    NameDescription
    X-NCP-APIGW-API-KEY-IDNCP 앱 등록 시 발급받은 Client ID
    X-NCP-APIGW-API-KEYNCP 앱 등록 시 발급받은 Secret Key

    Parameter

    NameTypeRequiredDescription
    requestIdStringtrueTranslate API 요청 시 발급받은 Request ID

    Response

    json 형식으로 리턴

    Field NameTypeDescription
    dataJSON Object
    data.statusString현재 번역 진행단계
    - WAITING: 번역 대기
    - PROGRESS: 진행 중
    - COMPLETE: 번역 완료(다운로드 가능)
    - FAILED: 파일 번역 실패
    data.progressPercentInteger파일 번역 진행률(%)
    data.errCodeString에러코드. status가 FAILED일 경우 제공
    data.errMsgString에러 메시지. status가 FAILED일 경우 제공

    예제

    번역이 완료된 경우

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

    번역이 실패한 경우

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

    오류 코드

    {
      "error": {
        "errorCode": "25003",
        "message": "requestId is invalid"
      }
    }
    
    HTTP Status CodeCodeMessageDescription
    40125003requestId is invalid유효하지 않은 request ID로 요청한 경우
    40425006Not Found해당 문서번역의 정보가 없을 경우

    CURL Example

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

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.