/
trm/status

trm/status

Gets the status of an asynchronous operation.

An operation can be in progress, completed or failed.

NOTE: If you want to poll the system to know when an operation is done, please make sure to properly wait in between calls to this method.

For example you should wait 5 seconds or more in between calls. The system may automatically disable the API if it is called too frequently.

URL

(GET) /api/trm/status?requestid=

PARAMETERS

URL parameters are:

requestid

The ID of the operation as returned by an asynchronous API method

int, Mandatory

RESULTS

See Asynchronous Operation 


EXAMPLES

The result if the operation still runs in the background.

{
	"trm": {
		"requestid": 559,
		"isbatch": false,
		"status": "Waiting",
		"statusText": "Waiting..."
	}
}


Oups, this operation failed:

{
	"trm": {
		"requestid": 559,
		"isbatch": false,
		"status": "Failed",
		"statusText": "Operation failed!",
		"statusInfo": "The parameter xy was not properly supplied"
	}
}


The operation terminated with success. Results are included in the custom and/or results nodes.

Note that this is a sample result from resources/segments/view/export. It is used to export a job or project to XLIFF. The XLIFF file itself is downloaded with the "fileref" token - please see the documentation for more details.

{
	"trm": {
		"requestid": 0,
		"isbatch": false,
		"status": "Finished",
		"statusText": "Finished!"
	},
	"custom": {
		"fileref": "ea9c1adeb02f4a9ebe8771583c12fa6b",
		"filename": "export_wm-1180_en_fr.xlf",
		"segments": 10
	}
}



Related content

Asynchronous operations
Asynchronous operations
More like this
Creating API Keys
Creating API Keys
Read with this
Test status of an asynchronous operation by id
Test status of an asynchronous operation by id
More like this
Authentication
Authentication
Read with this
trm/list
trm/list
More like this
Lists
Lists
Read with this

Copyright Wordbee - Buzzin' Outside the Box since 2008