Task Query

Fresh

Query Task

URL: https://openapi.geelark.com/open/v1/task/queryMethod: POST

Parameter	Required	Type	Description
ids	Yes	array[string]	Task IDs (max 100)

Response Fields

Field	Type	Description
id	string	Task ID
planName	string	Task plan name
taskType	integer	Task type code
serialName	string	Cloud phone name
envId	string	Cloud phone ID
scheduleAt	integer	Scheduled time
status	integer	1=Waiting, 2=In progress, 3=Completed, 4=Failed, 7=Cancelled
failCode	integer	Failure code
failDesc	string	Failure description
cost	integer	Duration in seconds
shareLink	string	Share link (if requested)

Response Example

{
  "traceId": "123456ABCDEF",
  "code": 0,
  "msg": "success",
  "data": {
    "total": 1,
    "items": [
      {
        "id": "123456ABCDEF",
        "planName": "testAdd",
        "taskType": 1,
        "serialName": "myPhone",
        "envId": "123456654321",
        "scheduleAt": 1718744459,
        "status": 3,
        "cost": 120,
        "shareLink": "https://www.tiktok.com/@user/video/123"
      }
    ]
  }
}

---

Batch Query Tasks

URL: https://openapi.geelark.com/open/v1/task/batchQueryMethod: POST

Parameter	Required	Type	Description
page	Yes	integer	Page number
pageSize	Yes	integer	Page size (max 100)
planName	No	string	Filter by plan name
envId	No	string	Filter by cloud phone ID
status	No	integer	Filter by status
taskIds	No	array[string]	Filter by task IDs

---

Cancel Task

URL: https://openapi.geelark.com/open/v1/task/cancelMethod: POST

Parameter	Required	Type	Description
ids	Yes	array[string]	Task IDs to cancel

INFO

Running tasks can be cancelled. Completed or failed tasks cannot be cancelled.

---

Retry Task

URL: https://openapi.geelark.com/open/v1/task/retryMethod: POST

Parameter	Required	Type	Description
ids	Yes	array[string]	Task IDs to retry

---

Task Detail

URL: https://openapi.geelark.com/open/v1/task/detailMethod: POST

Parameter	Required	Type	Description
id	Yes	string	Task ID

Returns detailed task information including failure codes and reasons.