status (文書翻訳の進行状況の確認)
    • PDF

    status (文書翻訳の進行状況の確認)

    • PDF

    Article Summary

    概要

    • 文書ファイルの翻訳進行状況確認用 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言語検出失敗
    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.ntruss.com/doc-trans/v1/status?requestId=20201007_2522985202669'
    {"data":{"status":"COMPLETE"}}
    

    この記事は役に立ちましたか?

    What's Next
    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.