Help Center> Natural Language Processing> API Reference> NLP APIs> MT APIs> Document Translation Job Status Query
View PDF

Document Translation Job Status Query

Introduction

This API is used to obtain the document translation job status and temporary URL. The temporary URL can be used to obtain the translated document. Each temporary URL keeps valid for 10 minutes.

URI

  • URI format 
    GET /v1/{project_id}/machine-translation/file-translation/jobs/{job_id}
  • Parameter description
    Table 1 URI parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

    job_id

    Yes

    Document translation job ID, which can be obtained in Document Translation Job Creation

Request

N/A

Response

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

status

String

Current translation status. Possible values are as follows:

  • WAITING: The file is waiting to be translated.
  • BGEIN: The translation starts.
  • FINISHED: The translation is completed.
  • ERROR: An error occurred during the translation process.

url

String

Temporary URL. You can make a GET request to download the translation result. The URL keeps valid for 10 minutes. After the URL expires, call the API again to obtain a new URL.

error_code

String

For details, see the error code list. This parameter is not included when the translation job succeeds.

error_msg

String

Returned error message. This parameter is not included when the translation job succeeds.

Example

  • Example request 
    GET https://{endpoint}/v1/{project_id}/machine-translation/file-translation/567e6536-****-****-****-826321939656 

Request Header:  
    Content-Type:application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  • Successful example response 
    {
    "status": "FINISHED",
    "url": "https://****.obs.****.huawei.com:443/****?AccessKeyId=****&Expires=****&Signature=*****"
}
  • Failed example response 
    {
    "error_code": "NLP.0101",
    "error_msg": "Authentication failed. Verify the token."
}
Parent topic: MT APIs