检查飞行任务阻飞项 - 司空 2 OpenAPI V0.9

检查天气阻飞和GPS航线阻飞情况

请求参数

Path 参数

proj_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

begin_at

integer

可选

开始时间戳（秒），任务类型为单次定时任务、重复定时任务和连续执行任务时必须
example: 1712985600

示例值:

[1712985600]

business_type

enum<integer>

可选

任务的业务类型，执行任务的航线如果是AI航线，需要设置此字段值为1
required: false

枚举值:

cloud_to_cloud_id

string

可选

云云对接id
required: false

示例值:

105ddd05-34ce-46b6-a872-cb32b8c98f64

continuous_task_periods

array [array]

可选

连续计划的多个执行时段，如果是连续任务，此字段必须
required: false
min 1
max 48
unique

>= 1 items<= 48 items

integer

可选

default_name

string

必需

航线任务的默认名称
required: true

示例值:

["新建计划"]

dom

array[integer]

可选

一个月中的第几天
min 1
max 31

>= 1 items<= 31 items

示例值:

[1,2,3]

dow

array[integer]

可选

一周中的第几天
min 1
max 7

>= 1 items<= 7 items

示例值:

[1,2,3]

end_at

integer

可选

结束时间戳（秒），任务类型为重复定时任务和连续执行任务时必须
example: 1712985600

示例值:

[1712985600]

extended_begin_at

array[integer]

可选

重复计划的多个执行时间，任务类型为重复定时任务时必须，数组元素值为时间戳（秒）

>= 1 items<= 48 items

示例值:

[[1712985600,1712985600]]

interval

integer

重复间隔时间

可选

>= 1

示例值:

[1]

landing_dock_sn

string

可选

降落设备sn，当需要设置任务为蛙跳任务时（A机场起飞，B机场降落），此参数为必需参数
required: false

min_battery_capacity

integer

可选

当任务类型为连续执行任务时为必需参数，表示连续执行任务时要求飞行器的最低执行电量，支持设置为 50% ~ 100%，当飞行器电池充电至设置的电量时，飞行任务将自动开始执行。
min 50
max 100

>= 50<= 100

示例值:

[50]

name

string

飞行任务名称

必需

out_of_control_action_in_flight

enum<integer>

必需

航线失控动作：1-返航 2-继续执行
required: true
min 1
max 2

>= 1<= 2

枚举值:

示例值:

[1]

push_c2c_organization_uuid

string

可选

云云对接推送到组织的uuid
required: false

repeat_type

enum<integer>

可选

任务重复类型
enum: 0 1 2 3 4 5 6 7 8
0-不重复, 1-每几秒, 2-每几分钟, 3-每几小时, 4-每几天, 5-每几周, 6-每几月（按日期）, 7-每几月(按星期), 8-绝对每年

<= 8

枚举值:

012345678

示例值:

[1]

resumable_status

enum<string>

必需

续飞状态
required: true

枚举值:

automanual

示例值:

["auto"]

rth_altitude

number

必需

返航高度
required: true
min 15
max 1500

>= 15<= 1500

示例值:

[15]

rth_mode

enum<integer>

可选

返航高度模式: 0-智能高度，1-设定高度
required: true
min 0
max 1

>= 0<= 1

枚举值:

示例值:

[0]

string

执行任务的设备sn

必需

示例值:

["SN123456"]

subscription_alert_cloud_to_cloud_frequency

integer

可选

云云对接告警频率
required: false

subscription_alert_email_frequency

integer

可选

邮件告警频率
required: false

subscription_alert_phone_frequency

integer

可选

短信告警频率
required: false

subscription_alert_user_web_frequency

integer

可选

用户站内订阅频率
required: false

subscription_receive_type

array[string]

可选

订阅告警通知类型 : email, phone, user_web, cloud_to_cloud

示例值:

[["email","phone","user_web","cloud_to_cloud"]]

subscription_user_id

array[string]

可选

订阅用户ID列表
required: false

tags

array[string]

可选

云云对接标签
required: true
min 0
max 10
unique

<= 10 items

示例值:

[["tag1","tag2"]]

task_type

enum<integer>

必需

任务类型
required: true
enum: 1 2 3 5
-1 表示立即任务
-2 表示重复任务
-3 表示单次定时任务
-5 表示连续任务

>= 1<= 5

枚举值:

1235

示例值:

time_zone

string

必需

时区
example: asia/shanghai

示例值:

asia/shanghai

wayline_duration

number

可选

航线预估执行时间，单位秒
required: true
min 1

>= 1

示例值:

[1712985600]

wayline_precision_type

enum<integer>

可选

航线精度类型: 0-GPS，1-RTK
required: true
min 0
max 1

>= 0<= 1

枚举值:

示例值:

[0]

wayline_uuid

string

必需

任务执行的航线uuid

wom

integer

一个月中的第几周

可选

>= 1<= 4

示例值:

[1]

示例

{
    "begin_at": [
        1712985600
    ],
    "business_type": 1,
    "cloud_to_cloud_id": "105ddd05-34ce-46b6-a872-cb32b8c98f64",
    "continuous_task_periods": [
        [
            0
        ]
    ],
    "default_name": [
        "新建计划"
    ],
    "dom": [
        1,
        2,
        3
    ],
    "dow": [
        1,
        2,
        3
    ],
    "end_at": [
        1712985600
    ],
    "extended_begin_at": [
        [
            1712985600,
            1712985600
        ]
    ],
    "interval": [
        1
    ],
    "landing_dock_sn": "string",
    "min_battery_capacity": [
        50
    ],
    "name": "string",
    "out_of_control_action_in_flight": 1,
    "push_c2c_organization_uuid": "string",
    "repeat_type": 0,
    "resumable_status": "auto",
    "rth_altitude": [
        15
    ],
    "rth_mode": 0,
    "sn": [
        "SN123456"
    ],
    "subscription_alert_cloud_to_cloud_frequency": 0,
    "subscription_alert_email_frequency": 0,
    "subscription_alert_phone_frequency": 0,
    "subscription_alert_user_web_frequency": 0,
    "subscription_receive_type": [
        [
            "email",
            "phone",
            "user_web",
            "cloud_to_cloud"
        ]
    ],
    "subscription_user_id": [
        "string"
    ],
    "tags": [
        [
            "tag1",
            "tag2"
        ]
    ],
    "task_type": 1,
    "time_zone": "asia/shanghai",
    "wayline_duration": [
        1712985600
    ],
    "wayline_precision_type": 0,
    "wayline_uuid": "string",
    "wom": [
        1
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功响应，包含天气阻飞和GPS航线阻飞检查结果

Body

code

integer

响应码

可选

message

string

响应消息

可选

data

array[object (resp.CheckRTOResp) {3}]

可选

wayline_precision_rto

array[object (resp.WaylinePrecisionRTO) {3}] | null

可选

GPS航线阻飞检查结果列表

weather_rto

array[object (resp.WeatherRTO) {4}] | null

可选

天气阻飞检查结果列表

rtk_not_calibration_rto

object | null

可选

示例

{
    "code": 0,
    "message": "string",
    "data": [
        {
            "wayline_precision_rto": [
                {
                    "code": [
                        1
                    ],
                    "result": [
                        true
                    ],
                    "sn": [
                        "1234567890"
                    ]
                }
            ],
            "weather_rto": [
                {
                    "code": [
                        1
                    ],
                    "result": [
                        true
                    ],
                    "sn": [
                        "1234567890"
                    ],
                    "value": "string"
                }
            ],
            "rtk_not_calibration_rto": {}
        }
    ]
}