translate (문서 번역 요청)
    • PDF

    translate (문서 번역 요청)

    • PDF

    기사 요약

    개요

    • 문서 파일 번역 요청 API (POST)
    • 정상 업로드 시, Request ID를 발급 → Status/Download API 호출 시 사용
    • 동시 요청 제한(이미 번역 진행 단계에 있는 문서가 있을 경우, API 호출 제한)

    Header

    NameDescription
    Content-Typemultipart/form-data 형식으로 전송 필요
    X-NCP-APIGW-API-KEY-IDNCP 앱 등록 시 발급받은 Client ID
    X-NCP-APIGW-API-KEYNCP 앱 등록 시 발급받은 Secret Key

    Parameter

    NameTypeRequiredDescription
    sourceString{ko,ja,en,zh-CN}true소스 언어 코드
    * auto 설정 시, 자동으로 소스 언어 감지
    targetString{ko,ja,en,zh-CN}true타겟 언어 코드
    fileFiletrue번역할 파일

    Response

    json 형식으로 리턴

    Field NameTypeDescription
    dataJSON Object
    data requestidString요청한 파일 번역에 대한 Request id 발급

    요청 성공 시 Example

    {
      "data": {
        "requestId": "20201007_2522985202669_001"
      }
    }
    

    오류 코드

    {
      "error": {
        "errorCode": "25001",
        "message": "API call failed"
      }
    }
    
    HttpStatusCodecodemessageDescription
    40000006API call failed지원하지 않는 언어쌍, 파일 확장자로의 요청
    50025001API call failed내부 서버 에러
    41325004Request Entity Too Large제한된 파일 용량 초과 (100MB)
    42925005Too many requests현재 번역 중인 파일이 있는 경우

    CURL Example

    $ curl -X POST -F file=@a.xlsx -F source=ko -F target=en 'https://naveropenapi.apigw.gov-ntruss.com/doc-trans/v1/translate'
    {"data":{"requestId":"20201007_2522985202669"}}
    

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

    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.