📊 Get Translation Status

This API checks the status of a translation task. It can return either the page count of the uploaded document or the processing status of the translation.

📋 Basic Information

Method: GET
Path: https://api.bluente.com/api/20250924/blu_translate/check
Authentication: Required — Authorization: Bearer $BLUENTE_API_KEY

📝 Request Parameters

Query String

Field	Type	Required	Description
`entry`	string	Yes	The type of query. Options: `"get_page_count"` or `"get_status"`
`id`	int	Yes	Task ID returned from the Upload File API

Request Body

- (none required)

💡 Example

curl -X GET "https://api.bluente.com/api/20250924/blu_translate/check?entry=get_status&id=1" \
     -H "Authorization: Bearer $BLUENTE_API_KEY"

fetch("https://api.bluente.com/api/20250924/blu_translate/check?entry=get_status&id=1", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $BLUENTE_API_KEY"
  }
})

✅ Success Response Example

{
  "message": "success",
  "code": 0,
  "data": {
    "id": 1,
    "serviceCode": 0,
    "pageCount": 1,
    "status": "SERVICE_PROCESSED",
    "message": "File is ready for translation",
    "updatedAt": "2024-05-19 10:15:23"
  }
}

📊 Response Fields

Field	Type	Description
`message`	string	Response message, usually `"success"`
`code`	int	Status code, `0` means success
`data`	object	Main payload
└─ `id`	int	Task ID
└─ `serviceCode`	int	Internal service code
└─ `pageCount`	int	Number of pages in the uploaded document
└─ `status`	string	Current processing status (see status list below)
└─ `message`	string	Detailed status message
└─ `updatedAt`	string	Last updated timestamp

🏷️ Status Values

Status	Description
`UPLOADING`	The file is being uploaded, continue to wait.
`SERVICE_PROCESSING`	The file is being processed, continue to wait.
`SERVICE_PROCESSED`	File is processed and ready for translation. (At this point, call Translate File* API)*
`TRANSLATING`	The file is being translated, continue to wait.
`READY`	Translation completed. (At this point, call Download File* API)*
`ERROR`	Something went wrong. Stop checking and show an error message.

❌ Error Response Example

{
  "message": "task not found",
  "code": 404
}

📌 Notes

Always poll this API until the status becomes either READY or ERROR.
When status = SERVICE_PROCESSED, you should trigger the Translate File API.
When status = READY, you should call the Download File API.

Upload file Translate file