获取航线任务列表
GET
/openapi/v0.9/task/api/v2/workspaces/{proj_uuid}/flight-tasks
es-task-service
请求参数
Path 参数
proj_uuid
string
项目uuid
Query 参数
sn[]
array[string]
设备SN列表
示例值:
["SN123456"]
name
string
任务名称
示例值:
巡检任务001
begin_at
integer <int64>
开始时间戳（秒）
示例值:
1710921600
end_at
integer <int64>
结束时间戳（秒）
示例值:
1711008000
task_type
enum<integer>
任务类型
枚举值:
1234567
示例值:
1
status[]
array[integer]
任务状态列表
示例值:
["1: 任务启动失败","2:任务执行中","3:已暂停","4:执行中止","5:执行成功","6:已挂起","8:部分执行，低电量返航时会上报该状态","9:待执行"]
page
integer
页码
示例值:
1
page_size
integer
每页数量
<= 100
示例值:
20
target_task_uuid
string <uuid>
目标任务UUID
示例值:
4dbc6ef2-0e3c-4d47-8b32-552a44f573c5
media_upload_type
enum<integer>
媒体文件上传类型
枚举值:
012
示例值:
0
source
enum<integer>
任务来源
>= 0<= 10
枚举值:
01
示例值:
0
flight_task_status
enum<integer>
任务完成状态
枚举值:
12
示例值:
1
flight_task_type
enum<integer>
任务下发类型
枚举值:
12
Header 参数
x-user-token
string
必需
默认值:
{{x-user-token}}
示例值:
{{x-user-token}}
X-Request-Id
string
可选
默认值:
{% mock 'uuid' %}
示例值:
{% mock 'uuid' %}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/openapi/v0.9/task/api/v2/workspaces//flight-tasks?sn[]&name&begin_at&end_at&task_type&status[]=1: 任务启动失败&status[]=2:任务执行中&status[]=3:已暂停&status[]=4:执行中止&status[]=5:执行成功&status[]=6:已挂起&status[]=8:部分执行，低电量返航时会上报该状态&status[]=9:待执行&page&page_size&target_task_uuid&media_upload_type&source&flight_task_status&flight_task_type' \
--header 'x-user-token: {{x-user-token}}' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'X-Request-Id;'返回响应
🟢200成功
application/json
Body
HTTP响应模板
code
integer
响应码
message
string
响应消息
data
object
响应数据
list
array[object (FlightOperationVO) {49}] | null
可选
pagination
object
api_render.PagyInfo
示例
{
"code": 0,
"message": "success",
"data": {
"pagination": {
"page": 1,
"page_size": 50,
"total": 3
},
"list": [
{
"ID": 2757,
"created_at": "2025-06-06T14:26:42.379332+08:00",
"begin_at": "2025-06-08T14:30:00+08:00",
"end_at": "2025-06-08T18:30:00+08:00",
"flight_task_id": "a3ab86ab-7401-44a0-9602-f6b18cefbfa7",
"flight_piece_id": "a3ab86ab-7401-44a0-9602-f6b18cefbfa7",
"take_off_airport_sn": "8UUDM8800AU840",
"land_airport_sn": "",
"task_type": 5,
"flight_task_type": 1,
"flight_task_status": 1,
"task_status": 0,
"task_name": "新建计划76",
"user_id": "1742198009243802215",
"prj_uuid": "e11fdd52-cf40-4a81-a798-e49e73e51139",
"wayline_uuid": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"landing_dock_sn": "",
"run_at": null,
"completed_at": null,
"task_start_time": "2025-06-08T14:30:00+08:00",
"task_end_time": "2025-06-08T18:30:00+08:00",
"update_at": "2025-06-06T14:26:42.379332+08:00",
"uuid": "a3ab86ab-7401-44a0-9602-f6b18cefbfa7",
"sn": "8UUDM8800AU840",
"name": "新建计划76",
"id": 2050,
"status": 0,
"records": null,
"total_waypoints": 4,
"media_upload_status": 0,
"out_of_control_action_in_flight": 0,
"folder_id": 0,
"bid": "",
"current_waypoint_index": 0,
"resumable_status": "manual",
"is_break_point_resume": false,
"tags": null,
"cloud_to_cloud_id": "",
"source": 1,
"operations": null,
"exceptions": null,
"is_conflicted": false,
"is_target": false,
"user_name": "kenny",
"wayline": {
"id": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"name": "新建面状航线(43)-副本(3)",
"template_types": [
1
],
"action_type": 0
},
"drone_sn": "",
"wait_reason": 0,
"obstacle_avoidance_notify": ""
},
{
"ID": 2758,
"created_at": "2025-06-06T14:26:42.379332+08:00",
"begin_at": "2025-06-09T14:30:00+08:00",
"end_at": "2025-06-09T18:30:00+08:00",
"flight_task_id": "a960f38d-454b-4797-bc2f-5153676488dd",
"flight_piece_id": "a960f38d-454b-4797-bc2f-5153676488dd",
"take_off_airport_sn": "8UUDM8800AU840",
"land_airport_sn": "",
"task_type": 5,
"flight_task_type": 1,
"flight_task_status": 1,
"task_status": 0,
"task_name": "新建计划76",
"user_id": "1742198009243802215",
"prj_uuid": "e11fdd52-cf40-4a81-a798-e49e73e51139",
"wayline_uuid": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"landing_dock_sn": "",
"run_at": null,
"completed_at": null,
"task_start_time": "2025-06-09T14:30:00+08:00",
"task_end_time": "2025-06-09T18:30:00+08:00",
"update_at": "2025-06-06T14:26:42.379332+08:00",
"uuid": "a960f38d-454b-4797-bc2f-5153676488dd",
"sn": "8UUDM8800AU840",
"name": "新建计划76",
"id": 2051,
"status": 0,
"records": null,
"total_waypoints": 4,
"media_upload_status": 0,
"out_of_control_action_in_flight": 0,
"folder_id": 0,
"bid": "",
"current_waypoint_index": 0,
"resumable_status": "manual",
"is_break_point_resume": false,
"tags": null,
"cloud_to_cloud_id": "",
"source": 1,
"operations": null,
"exceptions": null,
"is_conflicted": false,
"is_target": false,
"user_name": "kenny",
"wayline": {
"id": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"name": "新建面状航线(43)-副本(3)",
"template_types": [
1
],
"action_type": 0
},
"drone_sn": "",
"wait_reason": 0,
"obstacle_avoidance_notify": ""
},
{
"ID": 2759,
"created_at": "2025-06-06T14:26:42.379332+08:00",
"begin_at": "2025-06-10T14:30:00+08:00",
"end_at": "2025-06-10T18:30:00+08:00",
"flight_task_id": "eb248571-5b1c-4a44-8455-c291d34ee670",
"flight_piece_id": "eb248571-5b1c-4a44-8455-c291d34ee670",
"take_off_airport_sn": "8UUDM8800AU840",
"land_airport_sn": "",
"task_type": 5,
"flight_task_type": 1,
"flight_task_status": 1,
"task_status": 0,
"task_name": "新建计划76",
"user_id": "1742198009243802215",
"prj_uuid": "e11fdd52-cf40-4a81-a798-e49e73e51139",
"wayline_uuid": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"landing_dock_sn": "",
"run_at": null,
"completed_at": null,
"task_start_time": "2025-06-10T14:30:00+08:00",
"task_end_time": "2025-06-10T18:30:00+08:00",
"update_at": "2025-06-06T14:26:42.379332+08:00",
"uuid": "eb248571-5b1c-4a44-8455-c291d34ee670",
"sn": "8UUDM8800AU840",
"name": "新建计划76",
"id": 2052,
"status": 0,
"records": null,
"total_waypoints": 4,
"media_upload_status": 0,
"out_of_control_action_in_flight": 0,
"folder_id": 0,
"bid": "",
"current_waypoint_index": 0,
"resumable_status": "manual",
"is_break_point_resume": false,
"tags": null,
"cloud_to_cloud_id": "",
"source": 1,
"operations": null,
"exceptions": null,
"is_conflicted": false,
"is_target": false,
"user_name": "kenny",
"wayline": {
"id": "3fdae676-6d09-418b-b3b0-0b5466f07b72",
"name": "新建面状航线(43)-副本(3)",
"template_types": [
1
],
"action_type": 0
},
"drone_sn": "",
"wait_reason": 0,
"obstacle_avoidance_notify": ""
}
]
}
}修改于 2025-06-27 12:02:20