全新司空 2 OpenAPI V1.0
  1. 任务管理
全新司空 2 OpenAPI V1.0
  • 认证鉴权
    • 认证鉴权教程
  • 系统服务
    • 司空公有云接入点信息
    • 查询司空 2 系统状态
      GET
  • 组织项目
    • 组织项目教程
    • 获取组织下的项目列表
      GET
    • 获取组织下的设备列表
      GET
    • 获取项目下的设备列表
      GET
    • 获取项目的存储上传凭证
      GET
    • 添加人员到项目
      PUT
  • 设备管理
    • 设备管理教程
    • 物模型获取
      GET
    • HMS信息获取
      GET
    • 实时控制指令下发
      POST
    • 机场相机切换
      POST
    • 飞行器镜头切换
      POST
    • 控制权获取
      POST
    • 控制权释放
      DELETE
    • 图传清晰度设置
      PUT
    • 自定义网络RTK标定
      POST
    • 指定设备进入中继对频模式(仅支持私有云与中继设备)
      POST
    • 查询中继对频的结果(仅支持私有云与中继设备)
      GET
  • 直播管理
    • 直播管理教程
    • 直播推流
      • 开启直播
    • 旁路推流(仅支持私有云)
      • 码流转发错误码
      • 创建码流转发器
      • 开启/关闭码流转发器
      • 获取码流转码器列表
      • 删除码流转发器
  • 任务管理
    • 任务管理教程
    • 创建飞行任务
      POST
    • 更新飞行任务状态
      PUT
    • 获取飞行任务信息
      GET
    • 获取飞行任务列表
      GET
    • 获取飞行任务产生的媒体资源
      GET
    • 获取飞行任务轨迹信息
      GET
  • 航线管理
    • 航线管理教程
    • 航线上传完成通知
    • 获取项目下的航线列表
    • 获取航线详情
  • 模型管理
    • 模型管理教程
    • 模型重建坐标系
    • 获取项目下的模型列表
    • 模型重建
    • 获取模型详情
  • 标注管理
    • 标注管理教程
    • 创建地图标注
  1. 任务管理

获取飞行任务信息

GET
https://es-flight-api-cn.djigate.com/openapi/v0.1/flight-task/{task_uuid}
获取飞行任务信息,开启航线任务飞行后,可通过此接口获取任务信息,任务运行过程中的状态,以及任务产生的媒体文件信息等。

请求参数

Authorization
在 header 添加参数
X-User-Token
示例:
X-User-Token: ********************
Path 参数
task_uuid
string 
必需
任务UUID,创建飞行任务成功后,会返回任务UUID。
示例值:
89328e80-04ee-4089-9482-6bb00ec6bede
Header 参数
X-Request-Id
string <uuid>
请求唯一标识
必需
默认值:
{{$string.uuid}}
X-Language
enum<string> 
可选
枚举值:
zhen
默认值:
zh
X-Project-Uuid
string 
项目编号
可选
默认值:
{{X-Project-Uuid}}
X-User-Token
string 
必需
X-User-Token
默认值:
{{X-User-Token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://es-flight-api-cn.djigate.com/openapi/v0.1/flight-task/89328e80-04ee-4089-9482-6bb00ec6bede' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'X-User-Token;'

返回响应

🟢200成功
application/json
Body
code
integer 
非0代表异常
必需
message
string 
消息提示
必需
data
object 
必需
name
string 
任务名称
必需
uuid
string 
任务UUID
必需
task_type
enum<string> 
可选
任务类型:当前仅支持即时任务
枚举值:
immediate
sn
string 
机场sn
必需
wayline_uuid
string 
航线uuid
必需
rth_mode
enum<string> 
返航模式
必需
枚举值:
optimalpreset
rth_altitude
integer 
返航高度
必需
out_of_control_action_in_flight
enum<string> 
必需
丢失信号后无人机动作
枚举值:
return_homecontinue_task
status
enum<string> 
必需
枚举值:
waitingstarting_failureexecutingpausedterminatedsuccesssuspendedtimeout
resumable_status
enum<string> 
自动断点续飞
必需
枚举值:
automanual
begin_at
string 
任务计划执行时间
必需
end_at
string 
任务计划结束时间
必需
folder_info
object 
必需
repeat_type
enum<string> 
任务重复模式
必需
枚举值:
nonrepeatingdailyweeklyabsolute_monthlyrelative_monthly
interval
integer 
必需
重复间隔时间: 最小1
>= 1
days_of_month
array[integer]
必需
每月执行日数组,每月第几天,1-31
days_of_week
array[integer]
必需
每周执行日数组,每周第几天,0-6,0=周日,1=周一
week_of_month
integer 
每月第几周,1-4
必需
>= 1<= 4
recurring_task_start_time_list
array[integer]
必需
重复任务的多个执行时间,秒级时间戳
continuous_task_periods
array [array] 
必需
连续任务的多个执行时段
min_battery_capacity
integer 
必需
连续执行最低执行电量
>= 50<= 100
示例
{
    "code": 0,
    "message": "success",
    "data": {
        "name": "新建计划1",
        "uuid": "0bbc74b4-5e5a-4390-9256-8e4ee08a241b",
        "task_type": "immediate",
        "status": "success",
        "sn": "7CTDM3D00BZNVZ",
        "wayline_uuid": "6eb90ac7-4ec8-4a2c-a470-746e7444e77c",
        "begin_at": "2024-10-29T16:51:47.818707+08:00",
        "end_at": "2024-10-29T16:53:58.818707+08:00",
        "out_of_control_action_in_flight": "return_home",
        "rth_altitude": 100,
        "rth_mode": "preset",
        "resumable_status": "manual"
    }
}
🟠401未授权
修改于 2025-04-09 09:52:44
上一页
更新飞行任务状态
下一页
获取飞行任务列表
Built with