1. Home
  2. Application 24/7
  3. SOAP requests
  4. getTaskStatus

getTaskStatus

Operation getTaskStatus returns status of operation with taskId.

Some requests (ie. startLogin, startRegister, addSlaves, etc.) returns id of created task instead of direct answer. In such case status (and result) of task can be checked using getTaskStatus method. Usually result of task is stored in json in additionalInfo field.

 

Note: every task has its timeout, after exceeding it, task is removed from task queue, therefore getTaskStatus will return ERR_TASK_DOES_NOT_EXISTS.

Example SOAP request:

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="ns1">
   <soapenv:Header/>
   <soapenv:Body>
      <ns1:getTaskStatus soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <taskId xsi:type="xsd:string">7W3A0N1N9I2E7N1TKLS54A9PTR</taskId>
      </ns1:getTaskStatus>
   </soapenv:Body>
</soapenv:Envelope>

 

Example SOAP response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ns1">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <ns1:getTaskStatusResponse>
         <return xsi:type="ns1:vuiSoapGetTaskStatusResponse">
            <requestStatus>SUCCESS</requestStatus>
            <requestStatusDescription>Request succeeded.</requestStatusDescription>
            <taskId>7W3A0N1N9I2E7N1TKLS54A9PTR</taskId>
            <type>REGISTER</type>
            <progressPercent>0</progressPercent>
            <status>PREPARATION</status>
            <additionalInfo>{
}</additionalInfo>
         </return>
      </ns1:getTaskStatusResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

 

Request parameters:

parameter type description
taskId string id of task
uniqueTransferId string transaction id
callback bool whether to send messages with task progress/status or not

 

Response parameters:

name type description
additionalInfo string additional info
status string task status
type string task type
progressPercent unsigned int progress percent
taskId string id of created task
requestStatus string result of request
requestStatusDescription string status description

 

Possible errors:

error description
ERR_INVALID_TASK_ID invalid task id
ERR_TASK_DOES_NOT_EXIST task with provided id does not exist
Was this article helpful to you? Yes No

How can we help?