Skip to content

Get Main Task List by UUID List ​

Batch query main task information by main task UUID list.

Interface Address:

text
/papi/zw/task/list

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID, see API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 characters of lowercase letters and digits

Body Parameters:

ParameterTypeRequiredDescription
taskIdListarray[string]YesMain task UUID list

Request Example:

json
{
  "taskIdList": [
    "5350ac07-254f-4757-b65b-3790bb968687"
  ]
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataarray[object]Return data
├─ subtaskIdstringSub-task UUID
├─ sequenceNointegerExecution sequence number
├─ operationNamestringOperation name
├─ statusintegerSub-task status: 1-Running 2-Success 3-Failed
├─ resultstringExecution result
├─ msgstringError message
├─ ctimeintegerCreation timestamp
├─ finishedTimeintegerCompletion timestamp
├─ platformstringPlatform
├─ ctrIdstringCloud phone CtrId
├─ ctrAliasstringCloud phone alias
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": [
    {
      "subtaskId": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
      "sequenceNo": 1,
      "operationName": "云机重启",
      "status": 2,
      "result": "success",
      "msg": "",
      "ctime": 1700000000000,
      "finishedTime": 1700000001000,
      "platform": "android",
      "ctrId": "ctr-xxx",
      "ctrAlias": "测试设备"
    }
  ],
  "msg": ""
}

OpenAPI Docs