Skip to content

Get Sub Task Page ​

Paginated query of sub task list by conditions.

Interface Address:

text
/papi/zw/subtask/page

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

Query Parameters:

ParameterTypeRequiredDescription
idsstringYesID list, comma-separated, e.g.: 1024,2048

Body Parameters:

ParameterTypeRequiredDescription
pageNointegerNoPage number, starting from 1, default 1
pageSizeintegerNoPage size, maximum 1000, default 10
statusintegerNoSub-task status: 1-Running 2-Success 3-Failed
taskSidstringNoMain task ID
operationNamestringNoOperation name

Request Example:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "status": 0,
  "taskSid": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
  "operationName": "异步安装应用"
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ listarray[object]Data list
├─├─ taskUuidstringMain task ID
├─├─ 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
├─├─ resDatastringResponse JSON
├─ totalintegerTotal count
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "taskUuid": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
        "subtaskId": "5350ac07-254f-4757-b65b-3790bb968687",
        "sequenceNo": 1,
        "operationName": "异步安装应用",
        "status": 2,
        "result": "success",
        "msg": "",
        "ctime": 1700000000000,
        "finishedTime": 1700000001000,
        "platform": "android",
        "ctrId": "ctr-xxx",
        "ctrAlias": "测试设备",
        "resData": "{}"
      }
    ],
    "total": 50
  },
  "msg": ""
}

OpenAPI Docs