List Task Executions
List task executions by task, robot, time, and status filters.
Endpoint Information
Section titled “Endpoint Information”- Name: List task executions
- Description: Returns a paginated list of task executions.
- Method:
POST - Path:
remoteApi/taskPage - Login required: No
- Permission required: Yes
Request Parameters
Section titled “Request Parameters”-
sendStatus·Integer· OptionalIssue status:
0not issued,1issued
Example:1 -
showUnExecuted·Boolean· OptionalWhether to include unexecuted tasks:
trueyes,falseno (default)
Example:false -
dogCode·String· OptionalRobot code
Example:1 -
patrolStartTime·String· OptionalInspection start date (
yyyy-MM-dd)
Example:2025-11-26 -
patrolEndTime·String· OptionalInspection end date (
yyyy-MM-dd)
Example:2025-11-26 -
statusArr·String· OptionalComma-separated execution statuses
Example:1,2 -
taskName·String· OptionalTask name
Example:Test interval task -
status·String· OptionalTask status:
1completed,2in progress,3paused,4terminated,5not executed,6overdue -
priority·Integer· OptionalPriority:
1lowest,2,3,4highest
Example:1 -
pageNo·Integer· OptionalPage number; defaults to
1
Example:1 -
pageSize·Integer· OptionalPage size; defaults to
10
Example:15
Request Example
Section titled “Request Example”{ "sendStatus": 1, "showUnExecuted": true, "dogCode": "DOG2011258510273380352", "patrolStartTime": "2025-11-26", "patrolEndTime": "2026-11-29", "statusArr": "1", "taskName": "Full Inspection 1", "status": 1, "priority": 1, "pageNo": 1, "pageSize": 15}Response
Section titled “Response”Task Information
Section titled “Task Information”| Field / Type | Description and Example |
|---|---|
stationNameString | Station name Example: Deep Robotics |
taskCodeString | Task-template code Example: 1991795775187267584 |
taskNameString | Task name; see the field examples below. |
taskExecuteCodeString | Unique task execution identifier; see the field examples below. |
priorityInteger | Priority: 1 lowest, 2, 3, 4 highest |
dogCodeString | Robot code Example: 001 |
taskTypeInteger | Task type: 1 standalone, 2 coordinated, 3 videoExample: 1 |
executeTypeInteger | Execution type: 1 immediate, 2 scheduled, 3 recurring, 4 interval-based |
patrolTypeString | Inspection type: 1 routine, 2 special, 3 focused, 4 customExample: 1 |
pointCodesString | Inspection points in the task; see the field examples below. |
pointCountInteger | Number of inspection points Example: 6 |
Progress and Timing
Section titled “Progress and Timing”| Field / Type | Description and Example |
|---|---|
taskProgressString | Task progress Example: 100% |
planStartTimeString | Planned start time (yyyy-MM-dd HH:mm:ss) |
startTimeString | Actual start time (yyyy-MM-dd HH:mm:ss) |
endTimeString | Actual end time (yyyy-MM-dd HH:mm:ss) |
Inspection Statistics
Section titled “Inspection Statistics”| Field / Type | Description and Example |
|---|---|
allCountInteger | Total number of inspections actually performed |
normalCountInteger | Number of normal results |
alarmCountInteger | Number of alarm results |
recognitionNormalCountInteger | Number of normal recognition results |
recognitionErrorCountInteger | Number of abnormal recognition results Example: 0 |
missCountInteger | Number of missed inspections Example: 0 |
Route and Execution Status
Section titled “Route and Execution Status”| Field / Type | Description and Example |
|---|---|
taskRoadMap<String,String> | Task route |
statusString | Task status: 1 completed, 2 in progress, 3 paused, 4 terminated, 5 not executed, 6 overdueExample: 1 |
sendStatusInteger | Issue status: 0 not issued, 1 issuedExample: 1 |
endActionInteger | Action after completion: 1 return to charge automatically, 2 remain in place |
Field Examples
Section titled “Field Examples”taskName
Test interval task-(20251128154000)taskExecuteCode
ysc001_1991795775187267584_20251128154000_tzzcpointCodes
a001_16,a001_19,a001_20,a001_21,a001_22,a001_7Response Example
Section titled “Response Example”{ "success": true, "code": 200, "msg": "Operation succeeded", "data": { "records": [ { "stationName": "Station XX", "taskCode": "2011260376679940096", "taskName": "Full Inspection 1-(20260114110728)", "taskExecuteCode": "1_2011260376679940096_20260114110728_mc5a", "priority": 1, "dogCode": "DOG2011258510273380352", "taskType": 1, "executeType": 1, "patrolType": "1", "pointCodes": "A1_12,A1_16,A1_19,A1_22,A1_7,A1_8", "pointCount": 6, "taskProgress": "100%", "planStartTime": "2026-01-14 11:07:29", "startTime": "2026-01-14 11:07:29", "endTime": "2026-01-14 11:11:12", "allCount": 6, "normalCount": 4, "alarmCount": 2, "recognitionNormalCount": 4, "recognitionErrorCount": 2, "missCount": 0, "taskRoad": { "A1": "-151.144200,15.114400,0.000000;-290.778800,20.984300,0.000000;-941.101100,48.322300,0.000000;-151.144200,15.114400,0.000000;-0.022400,11.025300,0.000000" }, "status": "1", "sendStatus": 1, "endAction": null }, { "stationName": "Station XX", "taskCode": "2011260376679940096", "taskName": "Full Inspection 1-(20260114110044)", "taskExecuteCode": "1_2011260376679940096_20260114110044_y0dq", "priority": 1, "dogCode": "DOG2011258510273380352", "taskType": 1, "executeType": 1, "patrolType": "1", "pointCodes": "A1_12,A1_16,A1_19,A1_22,A1_7,A1_8", "pointCount": 6, "taskProgress": "100%", "planStartTime": "2026-01-14 11:00:45", "startTime": "2026-01-14 11:03:30", "endTime": "2026-01-14 11:07:22", "allCount": 6, "normalCount": 4, "alarmCount": 2, "recognitionNormalCount": 4, "recognitionErrorCount": 2, "missCount": 0, "taskRoad": { "A1": "-151.144200,15.114400,0.000000;-290.778800,20.984300,0.000000;-941.101100,48.322300,0.000000;-151.144200,15.114400,0.000000;-0.022400,11.025300,0.000000" }, "status": "1", "sendStatus": 1, "endAction": null }, { "stationName": "Station XX", "taskCode": "2011260376679940096", "taskName": "Full Inspection 1-(20260114105950)", "taskExecuteCode": "1_2011260376679940096_20260114105950_x6co", "priority": 1, "dogCode": "DOG2011258510273380352", "taskType": 1, "executeType": 1, "patrolType": "1", "pointCodes": "A1_12,A1_16,A1_19,A1_22,A1_7,A1_8", "pointCount": 6, "taskProgress": "100%", "planStartTime": "2026-01-14 10:59:50", "startTime": "2026-01-14 10:59:51", "endTime": "2026-01-14 11:03:31", "allCount": 6, "normalCount": 4, "alarmCount": 2, "recognitionNormalCount": 4, "recognitionErrorCount": 2, "missCount": 0, "taskRoad": { "A1": "-151.144200,15.114400,0.000000;-290.778800,20.984300,0.000000;-941.101100,48.322300,0.000000;-151.144200,15.114400,0.000000;-0.022400,11.025300,0.000000" }, "status": "1", "sendStatus": 1, "endAction": null }, { "stationName": "Station XX", "taskCode": "2011260376679940096", "taskName": "Full Inspection 1-(20260114101345)", "taskExecuteCode": "1_2011260376679940096_20260114101345_4nuv", "priority": 1, "dogCode": "DOG2011258510273380352", "taskType": 1, "executeType": 1, "patrolType": "1", "pointCodes": "A1_12,A1_16,A1_19,A1_22,A1_7,A1_8", "pointCount": 6, "taskProgress": "100%", "planStartTime": "2026-01-14 10:13:46", "startTime": "2026-01-14 10:13:46", "endTime": "2026-01-14 10:17:51", "allCount": 6, "normalCount": 4, "alarmCount": 2, "recognitionNormalCount": 4, "recognitionErrorCount": 2, "missCount": 0, "taskRoad": { "A1": "-151.144200,15.114400,0.000000;-290.778800,20.984300,0.000000;-941.101100,48.322300,0.000000;-151.144200,15.114400,0.000000;-0.022400,11.025300,0.000000" }, "status": "1", "sendStatus": 1, "endAction": null } ], "total": 4, "size": 15, "current": 1, "pages": 1 }}Error Codes
Section titled “Error Codes”| Code | Description |
|---|---|
| 400 | Invalid parameters |
| 401 | Unauthorized |
| 403 | Access denied |
| 404 | Resource not found |
| 500 | Internal server error |