# 【私有化】司空 2 OpenAPI V2.0 ## Docs - 调用指南 [认证鉴权教程](https://henvmbbf6x.apifox.cn/8983503m0.md): - 调用指南 [错误码](https://henvmbbf6x.apifox.cn/8983516m0.md): - 调用指南 [请求结构](https://henvmbbf6x.apifox.cn/8983485m0.md): - 调用指南 [返回结果](https://henvmbbf6x.apifox.cn/8983500m0.md): - 调用指南 [公共参数](https://henvmbbf6x.apifox.cn/8983495m0.md): - 公共基础 [公共基础教程](https://henvmbbf6x.apifox.cn/8983521m0.md): - 组织与项目 [组织与项目教程](https://henvmbbf6x.apifox.cn/8983522m0.md): - 设备管理 [设备管理教程](https://henvmbbf6x.apifox.cn/8983525m0.md): - 实时控制 [实时控制教程](https://henvmbbf6x.apifox.cn/8983527m0.md): - 飞行任务 [飞行任务教程](https://henvmbbf6x.apifox.cn/8983529m0.md): - 航线 [航线教程](https://henvmbbf6x.apifox.cn/8983533m0.md): - 地图 [地图教程](https://henvmbbf6x.apifox.cn/8983538m0.md): - 直播 [直播教程](https://henvmbbf6x.apifox.cn/8983539m0.md): - 媒体 [媒体教程](https://henvmbbf6x.apifox.cn/8983540m0.md): - 模型 [模型教程](https://henvmbbf6x.apifox.cn/8983542m0.md): - 模型 > 模型重建 [模型重建坐标系](https://henvmbbf6x.apifox.cn/8992101m0.md): - 开放建模 [开放建模教程](https://henvmbbf6x.apifox.cn/8996219m0.md): - 开放建模 [错误码](https://henvmbbf6x.apifox.cn/8996220m0.md): - 开放建模 [更新日志](https://henvmbbf6x.apifox.cn/8996221m0.md): - 开放建模 [算法参数介绍](https://henvmbbf6x.apifox.cn/8996222m0.md): - 回收站 [回收站教程](https://henvmbbf6x.apifox.cn/8983543m0.md): - 高级能力 [高级能力教程](https://henvmbbf6x.apifox.cn/8983545m0.md): ## API Docs - 公共基础 > 系统健康与接入 [DRC 服务健康检查](https://henvmbbf6x.apifox.cn/470807705e0.md): 实时控制服务的存活探针。供运维平台、负载均衡器、监控告警链路用来判断服务是否仍可对外提供能力。**不返回任何业务数据**——只用响应是否为 `code=0` 来判定服务是否就绪。本接口建议仅供基础设施层调用,业务侧不应直接依赖。 - 公共基础 > 接入与授权 > STS 凭证 [获取业务模块定制 STS 凭证](https://henvmbbf6x.apifox.cn/470807706e0.md): 业务模块自助申请「客户端直传文件到对象存储」的临时凭证。 调用方声明自己属于哪个业务模块(`usage`)、是否是临时数据(`temp`)、可选的子路径(`path`),平台返回一组短期有效的 OSS / S3 凭证 + 必须遵守的对象 key 前缀。客户端拿到凭证后用对象存储 SDK 直接上传,平台不中转文件流。 - 公共基础 > 接入与授权 > STS 凭证 [获取项目级文件直传 STS 凭证](https://henvmbbf6x.apifox.cn/470807707e0.md): 项目空间内的「文件直传」通用凭证申请接口。 前端 / Pilot 端在上传飞行原始文件、媒体素材等之前调用本接口,拿到 STS 临时凭证 + 一段强制路径前缀,然后用对象存储 SDK 直接 PUT 文件。**本接口不绑定具体业务模块**(区别于 `custom-sts` 必须声明 usage),适合通用上传场景。 **路径前缀规则**:默认形如 `{组织 UUID}/{项目 UUID}/{平台生成的随机串}`。同一次直传分片可以多次复用同一前缀;不同上传任务用不同随机串隔离。 **特殊用法**: - 公共基础 > 接入与授权 > STS 凭证 [获取飞行记录上传 STS 凭证](https://henvmbbf6x.apifox.cn/470807708e0.md): 飞行记录文件上传专用的临时凭证查询接口。 **当一架次飞行结束需要把原始数据(飞控记录、黑匣子日志等)上传到云端时,调用本接口拿到限定到「该项目-该架次」目录前缀的 STS 临时凭证。** 与 `workspaces/{id}/sts` 的差异:本接口前缀**必须**包含项目 UUID + 飞行任务 ID(去掉连字符后的字符串),无法自定义;适合「一次飞行一个目录、目录内分片若干」的归档需要。 - 公共基础 > 安全 [解密飞行记录中的设备序列号(SN)](https://henvmbbf6x.apifox.cn/470807709e0.md): 将加密后的设备序列号(SN)批量还原为明文 SN。飞行任务记录中的设备 SN 以加密形式存储,调用方需要通过本接口将加密 SN 转换为可读的明文 SN,以便后续查询设备信息或展示给用户。 - 组织与项目 > 项目管理 > 项目配置 [获取项目自动录制配置](https://henvmbbf6x.apifox.cn/470807710e0.md): 查询当前项目的自动录制规则(哪些任务 / 哪些事件触发自动录制、录制时长、自动清理时间等)。 - 组织与项目 > 项目管理 > 项目配置 [配置项目自动录制规则](https://henvmbbf6x.apifox.cn/470807711e0.md): 更新项目的自动录制配置规则。 - 组织与项目 > 项目管理 > 项目基础信息 [创建项目](https://henvmbbf6x.apifox.cn/470807712e0.md): 在指定组织下创建项目,可同时初始化项目用户、项目设备、项目快速加入、项目坐标系、机库轮换、天气阻飞、媒体分享等配置 - 组织与项目 > 项目管理 > 项目基础信息 [更新项目信息](https://henvmbbf6x.apifox.cn/470807713e0.md): 更新项目元信息(改名 / 描述 / 工作中心点 / 项目共享配置 / 天气阻飞配置等)。 - 组织与项目 > 项目管理 > 项目基础信息 [获取项目详情](https://henvmbbf6x.apifox.cn/470807714e0.md): 查询指定项目详情。当前用户拥有项目编辑权限(超管/组管)时会返回 project_fast_join.code,否则该字段会被置空。is_project_updatable 标记当前用户是否可编辑。 - 组织与项目 > 项目管理 > 项目基础信息 [删除项目](https://henvmbbf6x.apifox.cn/470807715e0.md): 删除指定项目并连带清理:项目内所有成员/设备拓扑/AuthGroup/分享链接/通知;并把组织内自动订阅该项目的用户订阅列表中移除。响应 data 为被删除项目的最后一份快照(GetProjectRsp)。 - 组织与项目 > 项目管理 > 快速加入 [查询快速加入项目信息](https://henvmbbf6x.apifox.cn/470807716e0.md): 通过项目 ID 和快速加入码查询项目基本信息,用于加入前的预览确认。如果同时传入关联飞行器 SN,还会返回飞行器的推荐项目呼号。 - 组织与项目 > 项目管理 > 快速加入 [通过快速加入码加入项目](https://henvmbbf6x.apifox.cn/470807717e0.md): 使用项目快速加入码将当前用户加入指定项目。如果用户不在该项目所属组织中,会自动以临时成员身份加入组织。可选同时关联一台飞行器到项目中。 - 组织与项目 > 组织管理 [查询组织项目列表](https://henvmbbf6x.apifox.cn/470807718e0.md): 分页查询组织内项目列表; 当 usage=simple 时 返回 {list: [...]} 不分页, 否则按 page/page_size 分页返回 {list, pagination}。 - 组织与项目 > 组织管理 [更新当前用户订阅设置](https://henvmbbf6x.apifox.cn/470807719e0.md): 当前用户更新自己在指定组织内的某一类订阅设置(订阅开关 / 订阅项目范围 / 是否自动订阅新加入项目 / 接收通道)。 **业务约束**: - 组织与项目 > 组织管理 [获取组织详情](https://henvmbbf6x.apifox.cn/470807720e0.md): 查询组织详情(名称 / 简介 / Logo / 单位制 / 地理围栏配置 / MFA 启用状态 / 当前用户体验改进版本等)。当前用户角色为临时成员/普通成员时 organization_device_bind_code 字段会被置 null(不可见绑定码)。 - 组织与项目 > 组织管理 [更新组织信息](https://henvmbbf6x.apifox.cn/470807721e0.md): 更新组织名称 / Logo / 行业 / 介绍 / 单位制 / 围栏配置等。 - 组织与项目 > 成员与权限管理 > 角色与权限 [获取项目权限树定义](https://henvmbbf6x.apifox.cn/470807722e0.md): 获取当前组织下的初始化项目权限树 - 组织与项目 > 成员与权限管理 > 角色与权限 [查询组织内项目角色列表](https://henvmbbf6x.apifox.cn/470807723e0.md): 分页查询当前组织下所有项目角色(含预设角色)。 - 组织与项目 > 成员与权限管理 > 角色与权限 [批量创建项目级自定义角色](https://henvmbbf6x.apifox.cn/470807724e0.md): 在指定组织下批量创建角色;当前 仅 支持type=project - 组织与项目 > 成员与权限管理 > 角色与权限 [查询角色权限映射 (角色 ID → 权限列表)](https://henvmbbf6x.apifox.cn/470807725e0.md): 查询指定角色 (或当前组织全量角色) 的权限映射, 同时返回完整初始化权限树。 - 组织与项目 > 成员与权限管理 > 角色与权限 [删除组织自定义角色](https://henvmbbf6x.apifox.cn/470807726e0.md): 按 role_id 删除指定的项目级自定义角色;删除前会校验角色归属于本组织并尚未被任何用户使用。 - 组织与项目 > 成员与权限管理 > 角色与权限 [更新自定义角色](https://henvmbbf6x.apifox.cn/470807727e0.md): 更新指定角色的权限列表 / 名称。预设角色权限不可修改。 - 组织与项目 > 成员与权限管理 > 组织成员 [批量移除组织成员](https://henvmbbf6x.apifox.cn/470807728e0.md): 从组织中批量移除指定用户(按 user_id / account 匹配)。会同时清理用户在该组织所有项目内的成员身份和订阅。失败项以错误码 + 失败用户列表返回。 - 组织与项目 > 成员与权限管理 > 组织成员 [查询组织成员列表](https://henvmbbf6x.apifox.cn/470807729e0.md): 分页查询组织成员; 支持按 user_role / source_type 等条件筛选, 若指定 project_uuid 则要求调用者在该项目内可编辑。 - 组织与项目 > 成员与权限管理 > 组织成员 [批量添加组织成员](https://henvmbbf6x.apifox.cn/470807730e0.md): 组织管理员批量添加成员(账号需在用户中心已注册)。 **保护机制**: - 组织与项目 > 成员与权限管理 > 组织成员 [批量更新组织成员信息](https://henvmbbf6x.apifox.cn/470807731e0.md): 批量更新组织成员的角色 / 启用状态等。 - 组织与项目 > 成员与权限管理 > 组织成员 [查询当前用户在该组织内的身份与配置](https://henvmbbf6x.apifox.cn/470807732e0.md): 获取当前 Token 对应用户在指定组织内的成员信息 + 组织级订阅/单位/欧盟 C6/MFA/灰度等配置 - 组织与项目 > 成员与权限管理 > 组织成员 [更新当前用户的组织呼号](https://henvmbbf6x.apifox.cn/470807733e0.md): 更新当前登录用户在指定组织内的呼号(nickname)。同组织内呼号不可重复。 - 组织与项目 > 成员与权限管理 > 组织成员 [当前用户退出组织](https://henvmbbf6x.apifox.cn/470807734e0.md): 当前用户对所在组织执行操作(如离开组织)。 - 组织与项目 > 成员与权限管理 > 项目成员 [获取项目团队成员(在线)](https://henvmbbf6x.apifox.cn/470807735e0.md): 查询项目当前在线成员列表;通过 cloudbus.WebsocketGetUserEnterProjectAndPlatforms 拉取所有 web/app 登录用户,过滤后按平台分类组装(web 用户直接加入,RC 用户结合设备拓扑去重)。 - 组织与项目 > 成员与权限管理 > 项目成员 [获取项目用户列表](https://henvmbbf6x.apifox.cn/470807736e0.md): 查询项目全量用户列表。支持按角色过滤(prj_user_role)、按 nickname 排序。 - 组织与项目 > 成员与权限管理 > 项目成员 [更新当前用户的项目呼号](https://henvmbbf6x.apifox.cn/470807737e0.md): 更新当前登录用户在指定项目内的呼号(nickname),并返回该用户在项目内的完整角色信息。 - 设备管理 > 设备配置 > HMS 事件 [获取组织设备 HMS 事件列表](https://henvmbbf6x.apifox.cn/470807760e0.md): 在「组织维度的设备健康/告警面板」上分页拉取一组设备(机库 + 飞机)在指定时间段内产生的 HMS(飞行器健康管理系统)事件,支持按告警等级、模块、文案模糊搜索过滤,支持分页与排序。 常用于运维同学在控制台筛选近 N 小时内"提醒+警告"级别事件、按时间倒序定位最新报警,或按 SN 复盘单台设备的告警时间线。 鉴权说明:调用方需对该组织内设备具备查看权限;接口会基于设备拓扑做鉴权——若传入的 SN 未直接绑定到组织,会回溯查询其网关设备(如机库),网关已绑定该组织时也允许返回(适用于"机库已加入组织、飞机临时通过机库登录"场景)。 参数兜底:`level` 不传时等价于 `level=[1,2]`(提醒+警告);`sort_type` 不传默认 `DESC`,`sort_column` 不传默认按 `device_data_update_time`(最新事件在前)。 - 设备管理 > 设备配置 > HMS 事件 [更新组织设备 HMS 已读时间](https://henvmbbf6x.apifox.cn/470807761e0.md): 用户在「组织设备健康面板」上点击"全部已读"按钮时调用本接口,把指定设备的所有 HMS 事件标记为已读(已读时间设为当前时刻)。后续前端拉取 HMS 列表(「获取组织设备 HMS 事件列表」接口 / 「批量获取项目设备 HMS 事件」接口)时可基于该时间戳为分割线,区分新事件和历史事件。 调用成功后服务端会通过实时推送通道把最新已读时间分发到组织内(以及对应项目内)其他在线终端,让多人协作时已读状态保持一致。 鉴权说明:调用方需对该组织内目标设备具备查看权限;接口会先校验设备是否绑定组织,未直接绑定的设备走"未绑定设备在组织内"的备用校验路径(即通过其网关设备验证),与 「更新项目设备 HMS 已读时间」接口(项目维度只接受直绑设备)行为不同。 - 设备管理 > 设备配置 > HMS 事件 [更新项目设备 HMS 已读时间](https://henvmbbf6x.apifox.cn/470807762e0.md): 用户在「项目设备拓扑」点击"标记已读"时调用本接口,把指定设备的 HMS 事件已读时间更新为当前时间。后续同项目和组织内其他在线终端通过实时推送通道收到该已读时间更新,前端可同步刷新红点状态,避免多人协作时已读状态错位。 鉴权说明:调用方需为该项目成员,且目标设备需**直接绑定到该项目**(不走拓扑回溯)。这是与 「更新组织设备 HMS 已读时间」接口(组织维度可走拓扑回溯校验网关设备)的关键差异,调用项目维度接口时未直绑设备会返回 `code` 非 0(业务码 `DRCErrCodeDeviceNotInProject`)。 生效说明:调用成功后服务端会把最新 read_time 通过实时通道分发到该项目和组织两个维度的其他在线终端。 - 设备管理 > 设备配置 > HMS 事件 [批量获取项目设备 HMS 事件](https://henvmbbf6x.apifox.cn/470807763e0.md): 在「项目设备拓扑/团队页」上一次性拉取项目内一批设备最近 24 小时的 HMS 事件,并附带每台设备的"已读时间戳"。前端用此接口给项目内的设备列表打告警角标——设备最近事件 `device_data_update_time > read_time` 的视为新事件,需要红点提醒。 与 「获取组织设备 HMS 事件列表」接口 的差异:作用域是项目(不是组织)、不分页、查询窗口由服务端固定为最近 24 小时、level 固定为 [1,2](提醒+警告),不支持时间窗口、level、module 等过滤;按设备分组返回(每个 SN 一组事件 + 一个 read_time)。这些不可配置约束是为了和"项目页角标"业务定位一致——只展示需用户关注的近端事件。 鉴权说明:调用方需为该项目成员;接口会逐 SN 校验是否在该项目内,**单 SN 不在项目内会被静默从响应中剔除**(不会整体报错,调用方应以入参 SN 为基准核对响应中是否包含该 SN)。 - 设备管理 > 设备配置 > 设备影子 [更新组织设备影子配置](https://henvmbbf6x.apifox.cn/470807757e0.md): 向组织内已绑定的设备下发"期望状态"配置,常见用途包括夜航灯开关、跟拍模式参数、机库空调温度、补光灯亮度、是否启用降落辅助等设备级属性的远程修改。下发后由设备择机回应并把实际状态同步到云端。 语义说明:本接口的语义是"接受配置变更的下发请求"——下发即视作受理成功,最终是否生效以设备回应为准。`state` 数组中可放多组 `{desired: {...}}`,服务端会**按数组顺序串行执行**(设备不支持并发命令,云端并发会大概率失败);若前一个 desired 失败,会中断后续,**不是原子事务**。 鉴权说明:调用方需对该组织内设备具备组织维度的访问权限;对部分敏感属性(如机库强制开盖等),还需当前持有该设备的控制权(无控制权时返回 `code` 非 0,前端引导用户先抢占控制权)。这是与 「更新项目设备影子配置」接口(项目维度无控制权检查、但触发飞行记录通知)的关键差异。 参数取值:完整属性 key 列表与各属性取值范围以对应机型 SDK 文档为准;本接口只是配置下发通道,参数取值合法性由设备端按机型物模型校验。 - 设备管理 > 设备配置 > 设备影子 [更新项目设备影子配置](https://henvmbbf6x.apifox.cn/470807758e0.md): 与 「更新组织设备影子配置」接口 同样是设备影子配置下发,但作用域是项目(项目内已加入的设备)。常见用途与 「更新组织设备影子配置」接口 一致——夜航灯、跟拍模式、机库空调、补光灯亮度等。 两个接口的差异: - 设备管理 > 设备配置 > 设备影子 [查询组织设备物模型属性当前值](https://henvmbbf6x.apifox.cn/470807759e0.md): 查询指定设备的某一项物模型属性的当前运行值(如电量百分比、工作模式等)。属性名由机型物模型定义决定,返回值类型随属性而异。 - 设备管理 > 设备配置 > 通用配置指令 [对组织设备下发自定义指令(通用 cmds 通道)](https://henvmbbf6x.apifox.cn/470807752e0.md): 对组织设备下发配置类指令(设置/切换/开关/格式化/重启/标定等改变设备状态的操作)。{method} 路径参数决定指令类型,device_cmd_data 字段结构随 {method} 取值而变化。下发成功后返回指令批次 ID(bid),可通过 GET /manage-devices/cmds/{method}(「查询组织设备指令执行进度」接口)轮询进度与结果。 > 查询类指令(get_dock_network_conf / check_dock_network_link / query_wlm_dongle_apn_info / device_check 等)已拆分为独立端点,见同目录下各查询接口。 配置类 {method} 取值速查: - 设备管理 > 设备配置 > 通用配置指令 [查询组织设备指令执行进度](https://henvmbbf6x.apifox.cn/470807753e0.md): 通用 cmds 通道的进度查询接口。可同时查询多台设备在指定 {method} 下的指令执行状态、进度百分比、设备上报错误码、扩展数据等,用于客户端轮询展示设备指令执行情况(开盖中、上传日志中、网络测速中等)。本接口与 POST /manage-devices/cmds/{method}(「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口 — 下发指令)成对使用:调用方拿到 bid 后通过本接口轮询,直到 status 变为 ok / failed / timeout / canceled。 services 为动态 key map:key 为 method 名(与 path 中的 method 一致,如 set_ntp_conf / cover_open),value 为该 method 的进度详情,结构对所有 method 统一。 identifiers 不传时,使用 path 中的 method 作为单值过滤条件;query 中显式传入 identifiers 时优先级更高。 - 设备管理 > 设备配置 > 通用配置指令 [批量查询组织设备指令执行进度](https://henvmbbf6x.apifox.cn/470807754e0.md): 按设备 SN 列表批量查询当前组织内若干设备最近的指令执行进度。常用于运维场景下追踪指令的执行状态、进度百分比与终态。 - 设备管理 > 设备配置 > 通用配置指令 [对项目内设备下发指令](https://henvmbbf6x.apifox.cn/470807770e0.md): 通过项目维度的指令通道向项目内设备下发操作指令。`device_cmd_method` 决定指令类型,`device_cmd_data` 字段结构随 method 取值变化。下发成功后返回指令批次 ID(`bid`),用于后续轮询进度与结果。 **与组织级指令通道(「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口)的区别**: - 设备管理 > 设备配置 > 网络管理 [查询设备当前 NTP 服务器配置](https://henvmbbf6x.apifox.cn/470807738e0.md): 查询指定机场设备当前生效的 NTP 时钟同步服务器配置(IP/端口或域名)以及同步状态码,用于排查设备时间不准、上报时间戳异常等问题。 - 设备管理 > 设备配置 > 网络管理 [启动设备网络速度检测任务](https://henvmbbf6x.apifox.cn/470807739e0.md): 为指定机场设备启动一次网络速度检测任务,检测设备到测速节点的上下行带宽与延迟。任务下发成功后返回批次 ID,可凭此通过「查询网络测速结果」接口(「查询设备网络测速任务结果」接口)获取实际测速数据。 注意:本接口的指令类型由路由固定为 dock_speed_task,客户端**无需也不应在请求体中传 device_cmd_method**;客户端可选择性传入 device_cmd_data 以指定测速节点等参数,不传则使用默认配置。 - 设备管理 > 设备配置 > 网络管理 [查询设备网络测速任务结果](https://henvmbbf6x.apifox.cn/470807740e0.md): 按设备 SN 查询此前启动的网络测速任务的最新执行进度与结果(带宽、延迟等)。可同时查询多台设备。结果通过通用 cmds 进度结构返回,services 是动态 key map(key 固定为 dock_speed_task),value 为该测速任务的进度详情;ext 中携带测速结果具体字段,常见字段:upload_speed(上行 Mbps)/ download_speed(下行 Mbps)/ latency(延迟 ms)。 - 设备管理 > 设备配置 > 网络管理 [查询机库网络配置](https://henvmbbf6x.apifox.cn/470807741e0.md): 查询指定机库设备当前的网络配置(网卡模式、IP、DNS、代理等)。通过 cmds 通道下发查询指令,设备回复当前配置。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 get_dock_network_conf。 - 设备管理 > 设备配置 > 网络管理 [检测机库网络连接](https://henvmbbf6x.apifox.cn/470807742e0.md): 向机库设备下发网络连通性检测指令,检测指定链路类型(DNS、NTP、云平台等)的网络可达性,返回各链路诊断结果。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 check_dock_network_link。 - 设备管理 > 设备配置 > 网络管理 [查询 4G 模组 APN 配置](https://henvmbbf6x.apifox.cn/470807743e0.md): 查询飞行器或机库上指定 4G 模组的 APN 网络接入点配置(含公网/专网)。需指定模组归属设备和序列号。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 query_wlm_dongle_apn_info。 - 设备管理 > 设备配置 > RTK 配置 [查询设备的 RTK 网络账号信息](https://henvmbbf6x.apifox.cn/470807744e0.md): 查询指定设备在指定组织下保存的 RTK 网络账号(CORS 账号)信息,用于客户端展示当前已配置的网络 RTK 服务参数。该账号由「自定义网络 RTK 标定」接口(「自定义网络 RTK 标定」接口)成功后写入。 若该设备从未配置过 RTK 账号,各字段返回零值(字符串为空、数字为 0)。 - 设备管理 > 设备配置 > RTK 配置 [自定义网络 RTK 标定](https://henvmbbf6x.apifox.cn/470807745e0.md): 对指定机场设备发起自定义网络 RTK 标定流程,使用调用方提供的 CORS 账号参数取代默认的网络 RTK 配置,从而提升 RTK 定位精度。标定下发成功后,账号参数同步写入配置表(后续可通过 「查询设备的 RTK 网络账号信息」接口 查询),并向设备下发标定指令。 前置条件: - 设备管理 > 设备配置 > 对频管理 [查询设备对频信息](https://henvmbbf6x.apifox.cn/470807746e0.md): 查询当前组织下指定设备的对频关系(飞机端 / 遥控器端配对状态),用于客户端展示当前是否已对频以及对频对端信息。 - 设备管理 > 设备配置 > 对频管理 [设备对频指令下发](https://henvmbbf6x.apifox.cn/470807747e0.md): 向组织内指定设备下发对频指令,将飞机端与遥控器端建立配对(或解除配对)。pair_type 决定指令针对的对端类型,pair_enable 决定开启/关闭对频。下发成功后返回批次 ID,可凭此通过 「查询组织设备指令执行进度」接口 查询执行结果。 - 设备管理 > 设备配置 > 对频管理 [查询中继扫描结果](https://henvmbbf6x.apifox.cn/470807748e0.md): 获取中继设备扫描到的可连接飞行器/机库列表,用于中继配对前的设备发现。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 relay_scan_result。 - 设备管理 > 设备配置 > 对频管理 [查询中继非配对连接结果](https://henvmbbf6x.apifox.cn/470807749e0.md): 获取中继设备在非配对模式下的临时连接状态与结果。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 relay_non_pair_attach_result。 - 设备管理 > 设备配置 > 对频管理 [查询配对请求结果](https://henvmbbf6x.apifox.cn/470807750e0.md): 查询中继设备的配对请求处理结果,确认配对是否成功。 本接口与 「对组织设备下发自定义指令(通用 cmds 通道)【查询类的以接口形态开发,保留配置类】」接口(通用 cmds 通道)共用同一条物理通道,{method} 路径段固定为 query_request_pair_result。 - 设备管理 > 设备配置 > SIM 卡管理 [查询设备 SIM 卡套餐与流量信息](https://henvmbbf6x.apifox.cn/470807751e0.md): 通过运营商接口查询指定 ICCID 对应的 SIM 卡套餐、在线状态、已用流量、信号强度等信息,用于客户端展示 4G 模组卡片状态。响应字段大部分由运营商接口透传,字段命名与运营商协议保持一致(驼峰式 onlineStatus / operatorStr / expireTime 等)。 注意:path 中的 sn 仅用于路由构造,实际查询键为 query 参数 iccid;ICCID 必须由客户端从设备物模型中获取后再传入。 - 设备管理 > 设备配置 > 项目设备配置 [修改项目设备配置参数](https://henvmbbf6x.apifox.cn/470807755e0.md): **重要:单次调用只允许设置一个字段**——请求体中 common_config / flight_safe_config / payload_config / live_config 四组只能传其中一组,且组内字段也只设一个;调用方按一次一改的策略多次调用。 机场类设备允许四组字段,RM510 遥控器类设备仅允许 payload_config(其他被忽略)。 联动约束: - 设备管理 > 设备配置 > 项目设备配置 [获取项目设备配置](https://henvmbbf6x.apifox.cn/470807756e0.md): 按设备型号(机场类 / RM510 遥控器类)返回该设备在指定项目下保存的配置项,包括飞行安全配置(返航高度、失控行为、起飞高度等)、负载配置(高温报警、负载锁定)、通用设备配置(透传,key/value 由设备物模型定义)、直播配置(弱网模式)、起降区状态等。 返回字段集随设备型号而异: - 设备管理 > 设备列表管理 > 项目设备列表 [修改组织设备的当前工作项目](https://henvmbbf6x.apifox.cn/470807764e0.md): 将一台直连类设备(机场/通信设备/基站)切换到指定项目工作。该接口为复合接口: - 设备管理 > 设备列表管理 > 项目设备列表 [获取项目设备列表](https://henvmbbf6x.apifox.cn/470807765e0.md): 查询指定项目下已加入的所有设备及其基本信息,包括设备型号、项目内呼号、组织呼号。**本接口不分页,始终返回项目内全部设备**;响应中 `pagination` 字段固定为 `page=1`,`page_size` 与 `total` 相等。可通过 `usage=web_project_devices` 过滤掉遥控器、负载、电池和通信设备,仅保留飞行器和机场类设备。 - 设备管理 > 设备列表管理 > 项目设备列表 [获取项目内单个设备详情](https://henvmbbf6x.apifox.cn/470807766e0.md): 按项目 UUID + 设备 SN 取出单台设备在该项目的详情:含项目呼号、机型对象、是否为组织设备、组织呼号(若已加入组织)。常见调用场景是设备详情页右侧抽屉。 **字段命名提示**:本接口字段为 `device_sn`,与 「获取项目设备列表」接口 接口的 `sn` 是同一概念。 **调用条件**:调用方需在该项目中具有查看设备权限。 - 设备管理 > 设备列表管理 > 项目设备列表 [修改项目内设备项目呼号](https://henvmbbf6x.apifox.cn/470807767e0.md): 修改某台设备在项目视角下的呼号(项目呼号)。**业务约束**:若设备未加入组织,则呼号不允许为空(避免在项目侧无法识别);若设备已加入组织,本字段可以为空。 **调用条件**:调用方需在该项目内具有设备管理权限。 - 设备管理 > 设备列表管理 > 项目设备列表 [获取项目历史拓扑设备列表](https://henvmbbf6x.apifox.cn/470807768e0.md): 返回该项目"历史曾有过任务"但当前不在拓扑中的设备列表(用于计划库)。服务端先取项目当前设备,再向计划库取历史设备,做差集后按设备类型(飞行器/机场/通信/遥控器)落入不同结构展示。 **响应固定特征**(与 「获取项目设备物模型」接口 当前拓扑列表共用 schema):历史接口下,所有设备的 `device_online_status` 固定为 `false`,`is_device_pending_offline` 固定为 `false`,`device_state` 不返回(始终为 null)。 - 设备管理 > 设备列表管理 > 项目设备列表 [获取项目设备物模型](https://henvmbbf6x.apifox.cn/470807769e0.md): 返回项目内当前在线及离线待定期设备的完整拓扑结构与实时物模型状态。 ### 拓扑结构 每条拓扑记录按设备角色分组: - 设备管理 > 设备列表管理 > 组织设备列表 [查询组织设备简表](https://henvmbbf6x.apifox.cn/470807771e0.md): 分页查询组织内全部设备的简表,每条记录只包含设备 SN、设备呼号、设备类型、机型枚举对象 4 项核心信息。适用于"项目编辑"等场景里需要从组织设备池中挑选设备的下拉列表;字段较少、响应较轻。新业务推荐使用 「查询组织设备运维列表」接口 查询组织设备运维列表接口。 - 设备管理 > 设备列表管理 > 组织设备列表 [批量修改组织设备呼号](https://henvmbbf6x.apifox.cn/470807772e0.md): 一次性修改多台组织设备的"设备组织呼号"(即设备在该组织视角下的展示名)。请求体里逐项给出 `device_sn + device_callsign`,服务端逐条处理,失败的设备会以 `error_infos` 数组返回各自的 SN 与错误码,部分成功部分失败的场景常见于"该呼号已被其他设备占用"。 **调用条件**:调用方需是该组织的管理员/超级管理员。 - 设备管理 > 设备列表管理 > 组织设备列表 [修改单个组织设备呼号](https://henvmbbf6x.apifox.cn/470807773e0.md): 修改某台设备在组织视角下的呼号。与 「批量修改组织设备呼号」接口 批量版相比,本接口针对单台设备且通过路径参数定位 SN。 **调用条件**:调用方需是该组织的管理员/超级管理员。 - 设备管理 > 设备列表管理 > 组织设备列表 [批量移除组织设备](https://henvmbbf6x.apifox.cn/470807774e0.md): 将一组设备从组织中移除(解绑)。当目标设备是机场或通信设备等类型时,服务端会同步处理拓扑内的关联子设备(飞行器、子设备等),避免重新绑定时出现冲突。响应中通过 `data.devices` 返回处理失败的 SN 列表;若全部成功则 `data.devices` 为 null 或空数组。 **调用条件**:调用方需是该组织的管理员/超级管理员。 - 设备管理 > 设备列表管理 > 组织设备列表 [查询组织设备运维列表](https://henvmbbf6x.apifox.cn/470807775e0.md): 按设备类型(必填,如飞行器/机场/通信设备/电池等)分页查询组织内的设备运维详情;支持按机型主键、在线状态、固件升级状态、工作项目、加入时间区间、SN 切片等多维条件过滤,返回设备的丰富运维信息(在线、固件版本、工作状态、关联设备、机场离线位置等)。前端的"设备运维管理"主表用此接口。 - 设备管理 > 设备列表管理 > 组织设备列表 [查询组织内某类设备的机型主键列表](https://henvmbbf6x.apifox.cn/470807776e0.md): 在筛选场景里需要按"机型"做过滤(如选择"Matrice 30")时,前端通过此接口拿到该组织、该设备类型下所有出现过的机型主键列表,据此渲染下拉项。例如选了"飞行器(drone)",就只列组织内已存在的飞行器机型。 **调用条件**:调用方需是组织成员。 - 设备管理 > 设备列表管理 > 组织设备列表 [查询组织设备在线工作配额](https://henvmbbf6x.apifox.cn/470807777e0.md): 查询当前组织的"设备在线工作"配额上限以及已占用数量。前端在切换设备工作项目、绑定机场等场景下用此接口判断是否会超出额度,从而提前给出阻断或提醒。 **调用条件**:调用方需是该组织成员。 **说明**:本接口仅读取路径参数 `uuid`,无请求体、无查询参数。 - 实时控制 > 飞行控制指令 > 实时指令 [查询项目内设备命令执行进度](https://henvmbbf6x.apifox.cn/470807779e0.md): 按设备 SN 列表批量查询项目内若干设备最近的指令执行进度。与组织级查询能力相同,但鉴权范围限定在项目内 — 调用方为项目成员,所查询设备必须归属当前项目。 - 实时控制 > 飞行控制指令 > 实时指令 [下发飞行控制指令](https://henvmbbf6x.apifox.cn/470807780e0.md): 向项目内指定飞行器下发一条飞行控制指令。指令的具体方法名和参数结构由飞行器机型物模型决定(透传通道),服务端不约束指令内容,只校验设备归属与控制权后下发到设备。 - 实时控制 > 飞行控制指令 > 空中任务 [创建空中下发航线任务](https://henvmbbf6x.apifox.cn/470807781e0.md): 飞行器已经在空中执行任务时,临时下发一条新航线让其继续飞行(不必先返航再起飞),常用于动态调整任务、巡查路径切换、应急再派单等场景。下发后服务端会持久化任务并即时把航线指令推送到飞行器。 - 实时控制 > 飞行控制指令 > 空中任务 [控制航线任务(暂停 / 继续 / 取消)](https://henvmbbf6x.apifox.cn/470807782e0.md): 对正在执行的航线任务下发即时控制指令,让飞行器暂停在当前位置悬停、从暂停点继续执行、或取消任务返航。常用于飞行员临时干预、突发情况避让、提前结束任务等场景。 - 实时控制 > 飞行控制指令 > 指点飞行 [获取飞行任务的设备推荐结果](https://henvmbbf6x.apifox.cn/470807783e0.md): 按业务场景(指点飞行 / 普通航线起飞 / 蛙跳航线 / 双机接力 / 基站推荐 / 接处警等 8 类策略)+ 起点 / 终点位置,反推项目内可用的「机场 + 飞行器」组合并给出可达性 / 距离评分,供创建即时任务或航线任务时挑选执行设备。 **调用方**:已登录的项目成员。 **返回**:按可达性 / 距离排序的设备推荐列表;项目内无可用设备时返回空数组(不视为错误)。 - 实时控制 > 飞行控制指令 > 指点飞行 [飞向目标点(一键起飞)](https://henvmbbf6x.apifox.cn/470807784e0.md): 让飞行器从指定的机场 / 起飞设备直接起飞,并可选地立即飞向目标点(「起飞 + 指点」一气呵成)。常用于地图上点击目标点 → 一键派飞机过去执行查看 / 拍摄。 **前置条件**:调用方需先获取目标飞行器的飞行控制权。 **返回**:创建的指令任务标识 `flight_id` 与起飞内嵌的 fly-to 子任务 `fly_to_id`。 - 实时控制 > 飞行控制指令 > 指点飞行 [发起飞向多目标点任务](https://henvmbbf6x.apifox.cn/470807785e0.md): 让飞行器(已在空中)按顺序飞过指定的一组航点。与「一键起飞」中的单点 fly-to 区别:本接口面向已起飞的飞机做多点航迹规划。可在飞行过程中通过 `PUT /fly-to-points` 动态调整剩余航点、或通过 `DELETE /fly-to-points` 主动结束。 **前置条件**:调用方需持有目标飞行器的飞行控制权。 - 实时控制 > 飞行控制指令 > 指点飞行 [更新进行中的飞向目标点任务](https://henvmbbf6x.apifox.cn/470807786e0.md): 动态修改正在执行的 fly-to 任务的航点序列(如增删 / 调整中间点 / 改速)。飞行器在切换到下一个航点时按新序列继续飞行,无需停飞重发。 **并发约束**:同一 `fly_to_id` 不可并发更新;服务端使用基于 `fly_to_id` 的锁防止并发覆盖。 **前置条件**:调用方需持有目标飞行器的飞行控制权(与发起方一致)。 - 实时控制 > 飞行控制指令 > 指点飞行 [结束飞向目标点任务](https://henvmbbf6x.apifox.cn/470807787e0.md): 主动结束当前正在执行的 fly-to 任务。飞机停止前往剩余航点,按之前 `out_of_control_action` 的设定(悬停 / 返航 / 继续)处理后续状态。 - 实时控制 > 飞行控制指令 > 智能环绕 [进入 POI 环绕模式](https://henvmbbf6x.apifox.cn/470807788e0.md): 操作员选定一个目标点(经纬度 + 高度),下发后飞行器进入 POI(Point of Interest)模式,以指定半径围绕该点匀速绕飞,常用于巡检目标的 360 度环拍、空中盯防取证。 服务端会持久化一条 POI 任务记录,并在任务下发后即时下发一次速度同步指令;任意一步失败时该任务会被置为已终止状态。 - 实时控制 > 飞行控制指令 > 智能环绕 [退出 POI 环绕模式](https://henvmbbf6x.apifox.cn/470807789e0.md): 让正在执行 POI 环绕的飞行器退出环绕状态,回到普通悬停 / 待飞状态。 退出前服务端会先校验飞行控制权并查询当前 POI 任务,若目标飞机当前不在 POI 环绕中则直接报错。 - 实时控制 > 飞行控制指令 > 智能环绕 [更新 POI 环绕速度](https://henvmbbf6x.apifox.cn/470807790e0.md): 动态调整正在执行的 POI 环绕任务的飞行速度,飞机即时响应;服务端同步更新数据库中的速度记录。 若目标飞机参与多机协同(一拖多)任务,会异步将同一速度同步给关联设备。即使飞机当前不在 POI 环绕状态,服务仍会下发指令并更新 DB,但飞机可能拒收。 - 实时控制 > 飞行控制指令 > 智能环绕 [查询 POI 任务状态](https://henvmbbf6x.apifox.cn/470807791e0.md): 查询指定机场 / 飞机当前的 POI 环绕任务状态(中心点 / 半径 / 速度 / 负载索引)。常用于客户端刷新 POI 面板,或断线重连后恢复界面状态。 当目标飞机当前不在 POI 环绕中(或从未发起过 POI 任务)时,`data` 字段为 null。 - 实时控制 > 飞行控制指令 > 接力任务 [创建接力任务(双机轮转)](https://henvmbbf6x.apifox.cn/470807792e0.md): 创建接力任务(双机轮转):指定主、备两架飞机,在某个任务点交替执行同一个飞行任务(A 飞累了切给 B,B 飞累了再切回 A),由调度中心统一编排。 **典型调用前置**: - 实时控制 > 飞行控制指令 > 接力任务 [计算接力任务的最佳接力位置](https://henvmbbf6x.apifox.cn/470807793e0.md): 在创建接力任务前先调本接口:服务端会查询作业机所在机场位置 + 接力机当前位置(接力机在舱时取机场位置,在空中时取飞机实时位置)+ 设备 RTK 标定状态,**计算出接力机将要前往的"接力点"坐标和接力作业半径**。然后再调 `POST /flight-tasks/relay-missions` 创建任务。 接力作业半径 = 主作业机 RTK 已标定时半径较小,未标定时半径较大(具体值由部署环境配置决定)。 - 实时控制 > 飞行控制指令 > 接力任务 [编辑接力任务配置](https://henvmbbf6x.apifox.cn/470807794e0.md): 修改正在执行 / 已暂停的接力任务的可调参数(截止时间 / 失控动作 / 主备机各自的返航高度 / 接力机提前出发时间 / 指点飞行模式 / 速度等),无需重建任务。 - 实时控制 > 飞行控制指令 > 接力任务 [触发接力机主动起飞](https://henvmbbf6x.apifox.cn/470807795e0.md): 接力任务执行中,正常情况下接力机由调度中心根据 `early_departure_time`(提前出发时间)和主作业机电量自动起飞。本接口提供"主动起飞"能力 — 在接力机仍处于待调度状态(`relay_status=0` 待调度)时,由调用方手动触发接力机起飞前往接力点等待。 **调用前置条件(必须同时满足)**: - 实时控制 > 飞行控制指令 > 接力任务 [更新接力任务运行状态(暂停 / 恢复 / 取消)](https://henvmbbf6x.apifox.cn/470807796e0.md): 控制接力任务的运行流转:暂停 / 恢复运行 / 取消。三个动作分别对应不同的前置状态要求和副作用: - 实时控制 > 飞行控制指令 > 接力任务 [主动切换接力任务的执行机](https://henvmbbf6x.apifox.cn/470807797e0.md): 在接力任务执行过程中,主动触发主备机切换(绕过电量阈值的自动切换逻辑)。调用前接力机必须已经飞到接力点并就位。切换会把当前主备机角色对调(原主作业机变为新接力机,原接力机变为新主作业机),重新计算接力点,并向调度中心注册新的调度任务。 请求体中需提供切换后的主作业机 SN 和接力机 SN — 必须是已经在该任务编队中的两架机,本接口不支持引入新设备。 - 实时控制 > 控制权管理 > 设备控制权 [设备控制权操作(组织设备运维)](https://henvmbbf6x.apifox.cn/470807798e0.md): 组织设备运维场景下,对设备控制权进行多用户协同操作:申请控制权、进入抢占队列、取消申请、同意 / 拒绝转让、主动释放,共 6 种动作。后端按 control_operation_method 分发到对应业务流程,并涉及控制权状态机更新与异步消息通知。 适用于组织管理员对组织内设备(机场 / 飞行器)做控制权排障、转移、回收。 - 实时控制 > 控制权管理 > 设备控制权 [查询设备控制权状态(组织设备运维)](https://henvmbbf6x.apifox.cn/470807799e0.md): 查询当前组织设备的控制权占用与等待队列状态。返回当前控制权由谁持有、是否可被当前用户抢占等信息,配合「设备控制权操作」接口形成「申请-审批-释放」完整工作流。 - 实时控制 > 控制权管理 > 设备控制权 [获取(占用)云控角色](https://henvmbbf6x.apifox.cn/470807800e0.md): 当前用户对指定机场 / 飞行器申请并占用某个云控角色(如 flight_control 飞行控制权 / payload_control 负载控制权)。占用成功后该角色变为「云控」持有,所有相关用户立即收到 WebSocket 实时变更通知。 - 实时控制 > 控制权管理 > 设备控制权 [查询项目设备控制权状态](https://henvmbbf6x.apifox.cn/470807801e0.md): 查询项目下设备的控制权占用与等待队列状态。功能与组织维度的查询接口相同,区别在于鉴权域为项目,且持有人呼号优先返回项目内昵称。配合「项目设备控制权操作」接口形成「申请-审批-释放」完整工作流。 - 实时控制 > 控制权管理 > 设备控制权 [查询设备最近正在操作的项目内用户列表](https://henvmbbf6x.apifox.cn/470807802e0.md): 批量查询多个设备当前由哪些项目内用户在操作(通过设备指令链路侧的最近活跃记录),返回每台设备对应的「项目内用户列表」(user_id + 项目内呼号)。常用于查看在线协同情况、看板展示。 - 实时控制 > 控制权管理 > 设备控制权 [设备控制权操作](https://henvmbbf6x.apifox.cn/470807803e0.md): 项目维度的设备控制权多用户协同操作 — 申请、抢占队列、取消、同意 / 拒绝转让、主动释放,共 6 种动作。后端按 control_operation_method 分发到对应业务流程,并涉及控制权状态机更新与异步消息通知。 与组织维度接口相比,本接口鉴权域为项目,且持有人呼号优先返回项目内昵称。 - 实时控制 > 控制权管理 > 云控权限 [申请云控授权(向遥控器发起)](https://henvmbbf6x.apifox.cn/470807804e0.md): 云端用户向遥控器侧发起云控授权请求,遥控器持有人在端上同意 / 拒绝。该接口立即返回授权请求的业务追踪 ID(bid),授权结果由设备侧异步回调推送,不在本接口同步返回。 与「直接占用云控权」(POST /cloud_controls)不同:本接口走「请求-同意」流程,用于遥控器在场(A/B 控持有控制权)时需要征求人工同意的场景。 - 实时控制 > 控制权管理 > 云控权限 [批量查询飞行器云控权状态](https://henvmbbf6x.apifox.cn/470807805e0.md): 按 SN 列表批量查询项目内飞行器的云控权当前占用情况,了解每架飞行器的控制权由谁持有、持有哪类控制权(飞行控制 / 负载控制)、当前占用的网关以及权限版本号。单次最多 50 个 SN。 - 实时控制 > 控制权管理 > 云控权限 [获取(占用)云控权限](https://henvmbbf6x.apifox.cn/470807806e0.md): 当前用户对指定飞行器直接占用云控权(按 control_keys 粒度,可同时占用 flight + 多个 payload_{index}),无需遥控器同意。占用成功后,所有相关用户会立即收到 WebSocket 实时变更通知(reason=Acquire)。 与「申请云控授权」(POST /cloud_control_auth)的区别:本接口直接强占;后者走遥控器请求-同意流程。 - 实时控制 > 控制权管理 > 云控权限 [释放云控权限](https://henvmbbf6x.apifox.cn/470807807e0.md): 主动释放当前持有的指定飞行器云控权,按 control_keys 粒度释放,可同时释放 flight 与多个 payload_{index}。释放后下一个等待者可以接管,所有相关用户会收到 WebSocket 实时变更通知(reason=Release)。 - 实时控制 > 负载控制 > 相机控制 [下发负载控制指令](https://henvmbbf6x.apifox.cn/470807808e0.md): 向项目内指定飞行器的负载(云台 / 相机 / 喊话器等机载负载)下发控制指令,如云台俯仰 / 拍照 / 录像 / 切换镜头 / 缩放等。调用方需持有该飞行器的负载控制权才可执行指令。 - 实时控制 > 负载控制 > PSDK 设备 [下发 PSDK 指令](https://henvmbbf6x.apifox.cn/470807809e0.md): 向项目内指定的载荷开发套件(PSDK)设备透传下发指令,用于控制 PSDK 业务(如喊话器播放、第三方负载操作等)。`device_cmd_method` 与 `device_cmd_data` 由具体 PSDK 设备的物模型决定,服务端不做枚举校验,整体作为透传通道。`ext` 字段用于业务埋点(喊话器场景的播放参数会写入服务侧的指令日志)。设备必须归属当前项目。 - 实时控制 > 负载控制 > 喊话器 [打开飞行器双向语音通道](https://henvmbbf6x.apifox.cn/470807810e0.md): 为指定网关 SN 打开双向语音通道(典型场景:飞行器搭载的麦克风采集 + 飞行器搭载的喊话器播放,前端通过 RTC 接入)。服务端选择并初始化 RTC 服务商(声网 / 火山引擎 / Twilio 等)后下发通道接入参数(房间号、Token、UID 等),前端按 `provider` 字段选择对应的 RTC SDK 接入。 - 实时控制 > 负载控制 > 喊话器 [打开 DRC 实时控制通道](https://henvmbbf6x.apifox.cn/470807811e0.md): 为指定网关 SN 打开 DRC 实时控制通道(建立 RTC / WebSocket 通道用于实时下发飞行控制 / 负载控制指令、上报设备状态等)。服务端选择并初始化 RTC 服务商后下发通道接入参数。响应同时返回 `rt_channel` 与 `data_channel` 两个等价配置(用于前端版本兼容:旧版本读 `rt_channel`,新版本读 `data_channel`,两者内容一致)。 - 实时控制 > 负载控制 > 喊话器 [查询喊话器资源列表](https://henvmbbf6x.apifox.cn/470807812e0.md): 查询当前项目下的喊话器资源(音频文件 + TTS 文本)列表。仅返回已 `visible=true` 且未删除的资源;可按资源类型 (`file_type`) 过滤。响应中音频类资源会附带签名后的可直接下载 / 试听的 `object_url`(私有化部署下使用对象存储 SignURL 生成,公有云使用 CDN)。返回数组按 `created_at` 倒序;已软删除的资源(`deleted_at` 非空)不返回;`visible=false` 的预占位资源不返回。 - 实时控制 > 负载控制 > 喊话器 [创建喊话器资源](https://henvmbbf6x.apifox.cn/470807813e0.md): 在当前项目下创建一条喊话器语音资源。支持两种类型:音频文件(`file_type=audio`,先调用 STS 接口拿到上传凭证、把音频上传到对象存储、再调本接口提交 `object_key`);TTS 文本(`file_type=tts`,直接提交文本,服务端异步合成音频并转码)。两阶段录制场景(`create_scene=record`):前端录音→先调本接口 `visible=false` 创建占位索引→用户确认保存时调编辑接口置 `visible=true`,资源才出现在列表中。导入场景(`create_scene=import`):直接 `visible=true` 创建。 - 实时控制 > 负载控制 > 喊话器 [删除喊话器资源](https://henvmbbf6x.apifox.cn/470807814e0.md): 删除喊话器资源(音频文件或 TTS 索引)。删除是软删除——记录被标记 `deleted_at` 后从用户列表中消失,关联的对象存储文件由后台异步清理(保留窗口取决于部署策略)。 - 实时控制 > 负载控制 > 喊话器 [编辑喊话器资源](https://henvmbbf6x.apifox.cn/470807815e0.md): 编辑喊话器资源的元信息。两种典型使用场景:保存录音(录音上传完成后将 `visible` 置 `true`,资源开始出现在列表中);改名 / 改文本(修改 `name` 字段;TTS 资源还可改 `content`)。注意:本接口要求 `file_type` 与原值一致,不可修改类型。 - 实时控制 > 负载控制 > 喊话器 [获取喊话器音频上传 STS 凭证](https://henvmbbf6x.apifox.cn/470807816e0.md): 获取喊话器音频文件直传到对象存储(OSS / 私有化 S3)的 STS 临时凭证。典型上传流程:客户端调用本接口拿到 `credentials` + `object_key_prefix`;在 `object_key_prefix` 下追加文件名拼出完整 `object_key`;用 STS 凭证直接上传音频文件到对象存储;调用喊话器资源创建接口登记资源(携带 `object_key`)。 - 实时控制 > 起降协调 [查询起降协调区(TCA)实时状态](https://henvmbbf6x.apifox.cn/470807817e0.md): 查询当前项目内若干起降协调区(TCA, Terminal Control Area)的实时占用状态。TCA 用于多机同场起降的优先级避让 — 一个 TCA 由若干同区域机场组成,区内任一机场起降时整个 TCA 进入占用状态,避免其他机场同时起降产生冲突。 - 飞行任务 > 任务查询 [获取当前活动航线任务(DRC 实时控制)](https://henvmbbf6x.apifox.cn/470807818e0.md): 查询指定项目内、指定无人机 SN 当前活跃的空中航线任务(用于实时展示飞行状态)。 - 飞行任务 > 任务查询 [获取当前活动航线任务(任务管理)](https://henvmbbf6x.apifox.cn/470807819e0.md): 查询当前项目内、指定无人机 SN 当前活跃的空中航线任务(用于实时展示飞行状态)。 - 飞行任务 > 任务查询 [按 UUID 批量查询飞行任务详情](https://henvmbbf6x.apifox.cn/470807820e0.md): 给定一组飞行任务 UUID,一次性返回每个任务的完整详情(状态、时间、关联航线、媒体上传进度等)。适用于前端任务看板批量刷新状态、跨系统状态同步等场景。 - 飞行任务 > 任务查询 [查询飞行任务时间冲突列表](https://henvmbbf6x.apifox.cn/470807821e0.md): 创建重复 / 定时任务前调用:按传入的任务时间规则(task_type / repeat_type / begin_at / end_at 等)反向查询同一设备 SN 下已有的会发生时间冲突的任务列表,便于前端提示用户。 - 飞行任务 > 任务查询 [获取飞行任务详细信息(V2,含执行明细)](https://henvmbbf6x.apifox.cn/470807822e0.md): 获取指定任务的 V2 版详情,包含 V1 没有的执行轨迹明细 / 飞行架次列表 / 媒体采集汇总等。 - 飞行任务 > 任务查询 [查询机场最近 / 当前任务](https://henvmbbf6x.apifox.cn/470807823e0.md): 机场列表 / 最近任务:根据传入的机场 SN 列表批量查询每台机场当前 / 最近的一条任务(优先返回执行中 + 暂停中,其次返回最近一条失败 / 终止)。命中缓存直接返回,未命中回查持久层并回填缓存;同时附加「已读」状态。 - 飞行任务 > 任务查询 [获取任务飞行轨迹(V2)](https://henvmbbf6x.apifox.cn/470807824e0.md): 获取已结束飞行任务的实际飞行轨迹(按时间排序的航点经纬度 + 高度 + 时间戳序列),用于地图轨迹回放。 - 飞行任务 > 飞行记录 > 导出与下载 [飞行记录文件下载](https://henvmbbf6x.apifox.cn/470807825e0.md): 按对象存储 object_key 换取一个临时签名 URL,供客户端直接下载该飞行记录或 PSDK 资源。前端在拿到导出任务结果的 object_key 后,调用本接口获取可下载的签名 URL。 - 飞行任务 > 飞行记录 > 导出与下载 [查询飞行任务导出历史](https://henvmbbf6x.apifox.cn/470807826e0.md): 查询当前项目下的导出任务列表(含状态:进行中 / 已完成 / 失败 / 已取消),用户可在导出中心看到自己提交过的导出任务及下载链接。 - 飞行任务 > 飞行记录 > 导出与下载 [导出飞行任务记录(生成 zip 异步任务)](https://henvmbbf6x.apifox.cn/470807827e0.md): 把指定的若干飞行任务记录按文件类型导出(默认 Excel 格式)。导出是异步任务:本接口创建一个 export task 并返回 task_id,客户端轮询 `GET /flight-tasks/export` 看进度。完成后从 object_key 字段下载 zip。 导出的 Excel 明细报告中,当 metrics 包含 position_info 时,额外输出三列高度数据: - 飞行任务 > 飞行记录 > 导出与下载 [取消 / 删除导出任务](https://henvmbbf6x.apifox.cn/470807828e0.md): 取消进行中的导出任务(status=running 时)或删除已完成 / 失败的导出记录(status=finished/failed 时)。 - 飞行任务 > 飞行记录 > 操作日志 [查询飞行任务操作日志(V2)](https://henvmbbf6x.apifox.cn/470807829e0.md): 查询指定任务的操作日志(谁在什么时候做了什么操作:创建 / 编辑 / 挂起 / 取消等),用于审计追溯。 - 飞行任务 > 任务管理 [创建飞行任务](https://henvmbbf6x.apifox.cn/470807830e0.md): 创建一个飞行计划。task_type 决定语义:1-立即任务 / 2-重复任务 / 3-单次定时任务 / 5-连续任务。这是最核心的任务创建入口。 **调用前置(按需)** - 飞行任务 > 任务管理 [创建飞行任务(高级版,返回子任务)](https://henvmbbf6x.apifox.cn/470807831e0.md): 创建飞行计划的 V2 版本,与基础版区别在于:返回体里**带回子任务信息**(重复 / 连续任务会拆出多个子任务),方便 OpenAPI 调用方一次拿到完整的父子任务结构。 业务规则同基础版 `POST /flight-tasks`。 - 飞行任务 > 任务管理 [检查飞行任务是否满足下发条件](https://henvmbbf6x.apifox.cn/470807832e0.md): 创建任务前校验:指定设备 SN + 航线 UUID 的组合是否能成功下发任务(设备能力匹配、机场可用、航线合法等)。返回 warning 列表但不阻塞创建。 - 飞行任务 > 任务管理 [标记任务为已读状态](https://henvmbbf6x.apifox.cn/470807833e0.md): 把指定任务标记为「已读」 — 通常用于清除「最近异常任务」红点提示(用户查看任务结果后调用)。服务端将任务 UUID 写入持久层并刷新缓存哈希;后续 `recent` 接口该任务的 `read_status=true`。 - 飞行任务 > 任务管理 [检查飞行任务阻飞项](https://henvmbbf6x.apifox.cn/470807834e0.md): 用户点"创建任务"按钮前调本接口做「放行预检」,返回当前 + 降落机场的天气阻飞结果 + 移动部署模式下的 GPS 航线阻飞结果,避免用户提交后才被业务层卡住。 **业务约束**:本接口仅接受 `task_type=1`(立即任务),其他取值会被 400 拒绝。 - 飞行任务 > 任务管理 [支持断点续飞的立即任务](https://henvmbbf6x.apifox.cn/470807835e0.md): 用户在原始任务异常中断后(如电池低、设备失联),通过本接口快速基于原任务的断点信息一键创建一个新的立即任务,从断点继续飞行。基于原 task 记录,把名称 / 航线 / RTH / 续飞模式 / 断点 JSON / 航线时长等关键字段拷贝到新任务,并强制 `task_type=立即`、`is_break_point_resume=true`。 - 飞行任务 > 任务管理 [删除飞行任务](https://henvmbbf6x.apifox.cn/470807836e0.md): 删除指定 UUID 的飞行任务。仅未执行 / 已完成 / 已终止状态的任务可被删除;执行中任务删除会被拒绝。 - 飞行任务 > 任务管理 [编辑飞行任务](https://henvmbbf6x.apifox.cn/470807837e0.md): 编辑飞行计划:覆盖式更新任务的规则字段(时间、重复、设备、航线、失控动作、VLM 配置等)。 **适用范围**:仅可编辑待执行(尚未下发到设备)的定时任务、重复子任务、连续子任务。立即任务、试飞任务、断点续飞任务不可编辑。 - 飞行任务 > 任务管理 [获取飞行任务详情](https://henvmbbf6x.apifox.cn/470807838e0.md): 根据 task_uuid 获取一个飞行任务的完整详情(含规则、设备、航线、状态、子任务、VLM 配置、断点信息等)。 - 飞行任务 > 任务管理 [下发任务媒体优先上传指令](https://henvmbbf6x.apifox.cn/470807839e0.md): 针对指定飞行任务下发"媒体优先上传"指令(将任务相关媒体提前上传)。注:任务暂停 / 继续 / 终止 / 挂起等状态变更应使用 PUT /flight-tasks/{task_uuid}/status 接口。 - 飞行任务 > 任务管理 [创建续飞任务(保留原断点)](https://henvmbbf6x.apifox.cn/470807840e0.md): 基于已结束的任务创建一个续飞副本任务,从原任务的断点信息继续飞行。与 resume-immediate 区别:本接口是"复制定时任务",可保留原 task_type;resume-immediate 强制转为立即任务。 - 飞行任务 > 任务管理 [更新飞行任务挂起状态(挂起 / 解除挂起 / 取消)](https://henvmbbf6x.apifox.cn/470807841e0.md): 把任务挂起(暂时不下发到设备)/ 解除挂起 / 取消。挂起状态下任务保留在服务端但不会被自动调度。 - 飞行任务 > 任务管理 [查询飞行任务列表](https://henvmbbf6x.apifox.cn/470807842e0.md): 按多维度过滤查询当前项目下的飞行任务列表(V2)。支持按任务名、设备 SN、时间段、任务类型、状态等过滤;分页返回。 - 飞行任务 > AI 飞行告警 [按设备 SN 查询有 AI 告警的飞行架次列表](https://henvmbbf6x.apifox.cn/470807843e0.md): 给定一台飞行器 SN,查询该飞行器历史上产生过 AI 告警的飞行架次列表(每条返回一个 flight_id 及对应的告警条数)。常用于先选定一架飞行器,再翻看它的告警飞行历史。 - 飞行任务 > AI 飞行告警 [查询历史 AI 告警记录](https://henvmbbf6x.apifox.cn/470807844e0.md): 查询当前项目下 AI 算法历史触发的告警记录列表(按时间范围 / 设备 / 算法过滤)。 - 航线 > 下载与上传 [打包资源到 KMZ(精准复拍流程)](https://henvmbbf6x.apifox.cn/470807845e0.md): "精准复拍"流程:把上一次飞行采集的快照图(res/ 目录)与轻量 KMZ 合并打包成"任务副本航线",下次执行时按相同视角复拍。 服务端从 OSS 读取轻量 KMZ + 原航线引用的 res(图片 / 音频)两份内容,在 OSS 内合并打成完整 KMZ 后保存到航线库。 - 航线 > 下载与上传 [查询航线异步导入状态](https://henvmbbf6x.apifox.cn/470807846e0.md): `POST /import-callback` 触发的航线导入是异步流程(KMZ 解析、校验、保存元数据需要一定时间)。客户端通过本接口轮询导入是否完成、是否失败。 - 航线 > 下载与上传 [保存航线时 KMZ 上传完成回调](https://henvmbbf6x.apifox.cn/470807847e0.md): 客户端在航线编辑器保存航线时,先把生成的 KMZ 直传到 OSS,再调用本接口登记航线元信息(名称、所属文件夹、模板类型、payload 配置等),完成保存。 - 航线 > 下载与上传 [航线 KMZ 文件导入回调](https://henvmbbf6x.apifox.cn/470807848e0.md): 客户端把航线 KMZ 文件直传到 OSS 之后,调用本接口通知服务端登记导入状态。服务端解析 KMZ 元数据(航点、动作、负载要求等)后写入航线库,并触发同名校验、模板类型识别等后续流程。 - 航线 > 下载与上传 [批量下载航线 / 文件夹(打包 zip)](https://henvmbbf6x.apifox.cn/470807849e0.md): 批量下载多个航线文件或文件夹(含子内容)。服务端把所有 KMZ 文件打包成 zip,返回 OSS 签名下载 URL。 **使用场景**:用户在航线库勾选多个航线/文件夹后点"批量下载"。 - 航线 > 航线列表管理 [获取航线 KMZ 下载 URL 并 302 重定向](https://henvmbbf6x.apifox.cn/470807850e0.md): 移动客户端 / 司空端获取单条航线 KMZ 的下载 URL,本接口直接 302 跳转到 OSS 签名 URL,客户端无需二次取 URL。 **相关接口**:`POST /waylines/batch-download` — 多个文件批量打包下载。 - 航线 > 航线列表管理 [复制航线](https://henvmbbf6x.apifox.cn/470807851e0.md): 把指定航线复制一份新副本(包括 KMZ 文件、模板配置、payload 设置)。新航线名称默认为"原名 (copy)",可通过 `name` 字段覆盖;可指定 `parent_id` 把副本放到其他文件夹。 - 航线 > 航线列表管理 [收藏航线 / 媒体资源](https://henvmbbf6x.apifox.cn/470807852e0.md): 把指定资源 ID 加入当前用户在该项目下的收藏列表,后续可通过列表接口的 `favorited=true` 过滤参数快速找到。同一资源重复收藏会被去重。 - 航线 > 航线列表管理 [取消收藏航线 / 媒体资源](https://henvmbbf6x.apifox.cn/470807853e0.md): 从当前用户在该项目下的收藏列表中移除指定资源 ID。 - 航线 > 航线列表管理 [多航线拼接为一条](https://henvmbbf6x.apifox.cn/470807854e0.md): 把多条航线按指定顺序拼接成一条新航线(用于把多个短航线合并为长航线一次性执行)。服务端在 OSS 上合并 KMZ 文件并生成新的航线记录。 - 航线 > 航线列表管理 [航线库文件列表查询(V1)](https://henvmbbf6x.apifox.cn/470807855e0.md): Web 端航线库主列表接口:分页 + 多维度过滤(按航点动作类型、文件类型、产品型号、负载型号、模板类型、时间范围等),按更新时间倒序排列。 - 航线 > 航线列表管理 [删除指定航线(默认软删进回收站)](https://henvmbbf6x.apifox.cn/470807856e0.md): 删除指定 UUID 的航线。默认软删进回收站可恢复;传 query `destroy=true` 直接硬删不可恢复。被锁定的航线删除会被拒绝。 - 航线 > 航线列表管理 [更新航线元信息(改名 / 锁定 / 恢复回收站)](https://henvmbbf6x.apifox.cn/470807857e0.md): 更新指定 UUID 航线的元信息。按传入字段做差量更新:传 `name` 改名 / 传 `mod` 改锁定状态 / 传 `restore=true` 从回收站恢复。 - 航线 > 航线列表管理 [获取单条航线详情](https://henvmbbf6x.apifox.cn/470807858e0.md): 根据航线 UUID 获取航线详情,包含名称、所属文件夹、KMZ 文件大小、模板类型、payload 配置、AI 航线标识、是否含障碍物、起始航点坐标等。 - 航线 > 航线文件 CRUD [创建航线文件夹](https://henvmbbf6x.apifox.cn/470807859e0.md): 在当前项目的航线库中创建一个文件夹(用于组织航线层级)。可指定父文件夹 UUID 实现嵌套;不传父则放在根目录。 - 航线 > 航线文件 CRUD [批量删除航线 / 文件夹](https://henvmbbf6x.apifox.cn/470807860e0.md): 批量删除多个航线 / 文件夹。`ids` 列表里可同时包含航线 UUID 和文件夹 UUID,服务端逐项处理。 **默认软删**(资源进回收站,可恢复);传 `destroy=true` 时直接硬删(不可恢复)。 **锁定保护**:任一选中文件夹下存在被锁定的航线,或选中的航线本身被锁定时,整体删除被拒绝。 - 航线 > 航线文件 CRUD [批量移动航线 / 文件夹到目标文件夹](https://henvmbbf6x.apifox.cn/470807861e0.md): 批量把若干航线 / 子文件夹移动到目标父文件夹下。被锁定的资源会被拒绝移动。 - 航线 > 航线文件 CRUD [批量更新航线 / 文件夹锁定状态](https://henvmbbf6x.apifox.cn/470807863e0.md): 批量把若干航线或文件夹设为"锁定"或"解锁"。锁定后的航线 / 文件夹不可被移动、删除、改名。 - 地图 > 地图标注 > 标注图层管理 [移动 / 重排图层与要素](https://henvmbbf6x.apifox.cn/470807864e0.md): 把若干图层/要素移动到目标父图层下,并可同时调整顺序。要素移到根目录返回 211003;Default/Share 不可移到其他目录(211002);VisualCone 不可移动(211011)。 - 地图 > 地图标注 > 标注图层管理 [删除单个标注图层(文件夹)](https://henvmbbf6x.apifox.cn/470807865e0.md): 删除指定的单个图层;级联删除其所有子图层和要素。锁定状态会被拒绝(211403);Share/Default/VisualCone 类型不允许删除(211002)。 - 地图 > 地图标注 > 标注图层管理 [更新标注图层(改名 / 重排)](https://henvmbbf6x.apifox.cn/470807866e0.md): 更新图层名称或重排图层顺序。当 orders 非空时执行批量排序,name 字段被忽略。Share/Default/VisualCone 类型不允许改名(211002)。 - 地图 > 地图标注 > 标注图层管理 [分发标注图层到设备端](https://henvmbbf6x.apifox.cn/470807867e0.md): 把指定图层及其所有子图层标记为已分发,设备端会拉取这些图层用于地图展示。 - 地图 > 地图标注 > 标注图层管理 [锁定 / 解锁标注图层](https://henvmbbf6x.apifox.cn/470807868e0.md): 锁定指定图层及其所有子图层;锁定后该图层及其子图层不可被删除/批量删除/子要素操作;查询和锁定切换不受限。 - 地图 > 地图标注 > 标注图层管理 [取消分发标注图层](https://henvmbbf6x.apifox.cn/470807869e0.md): 把指定图层及其所有子图层取消分发;Share 类型不可取消分发(必须保持分发,返回 211002)。 - 地图 > 地图标注 > 标注图层管理 [批量删除标注图层 / 要素](https://henvmbbf6x.apifox.cn/470807870e0.md): 一次性删除多个图层和/或要素;删除图层会级联删除其所有子图层和要素。任一目标图层处于锁定状态会拒绝(211403);不允许删除 Share/Default/VisualCone 类型(211002)。 - 地图 > 地图标注 > 标注图层管理 [创建标注图层(文件夹)](https://henvmbbf6x.apifox.cn/470807871e0.md): 在指定项目下创建一个新的标注图层;可选 pid 创建子图层。若 pid 指向的父图层处于锁定状态,会返回业务错误码 211007。 - 地图 > 地图标注 > 标注图层管理 [查询标注图层(文件夹)列表](https://henvmbbf6x.apifox.cn/470807872e0.md): 查询当前项目下所有标注图层(含子图层)及图层下要素列表;支持按图层类型/分发状态过滤。 - 地图 > 地图标注 > 标注要素管理 [批量修改图层下要素的显示状态](https://henvmbbf6x.apifox.cn/470807873e0.md): 把指定图层及其子图层下所有未锁定要素的显示状态统一改为隐藏或显示。 - 地图 > 地图标注 > 标注要素管理 [清空指定图层下的所有标注要素](https://henvmbbf6x.apifox.cn/470807874e0.md): 清空指定图层下的所有要素(仅删除要素,保留图层);锁定状态会被拒绝。 - 地图 > 地图标注 > 标注要素管理 [在指定图层下创建标注要素](https://henvmbbf6x.apifox.cn/470807875e0.md): 在指定图层下创建一个标注要素(点 / 线 / 多边形 / 圆 / 图钉 等)。 - 地图 > 地图标注 > 标注要素管理 [批量导入图层及标注(KML 风格 JSON)](https://henvmbbf6x.apifox.cn/470807876e0.md): 按层级结构批量创建多个图层文件夹及其下的标注要素。请求体为 KML 风格的 JSON(不是 KML XML 文件)。 - 地图 > 地图标注 > 标注要素管理 [导出图层组下要素(KML 风格 JSON)](https://henvmbbf6x.apifox.cn/470807877e0.md): 按 group_id 列表导出对应图层及其要素(KML 风格 JSON 结构,含图层 + 要素 + 样式 + 坐标)。 - 地图 > 地图标注 > 标注要素管理 [删除单个标注要素](https://henvmbbf6x.apifox.cn/470807878e0.md): 删除指定要素;要素所属图层处于锁定状态会被拒绝。 - 地图 > 地图标注 > 标注要素管理 [更新标注要素(改名 / 改坐标 / 改样式 / 改顺序)](https://henvmbbf6x.apifox.cn/470807879e0.md): 更新单个要素的部分字段;所有字段都是可选;content 按 JSON merge patch 合并(与现有 content 合并而非整段替换)。 - 地图 > 地图标注 > 自定义图标 [查询项目自定义点位图标库](https://henvmbbf6x.apifox.cn/470807880e0.md): 返回当前项目下所有自定义图标列表(含签名 URL,可直接用于地图渲染)。 - 地图 > 地图标注 > 自定义图标 [注册自定义点位图标](https://henvmbbf6x.apifox.cn/470807881e0.md): 将一个已上传至 OSS 的图标文件注册到项目;图标文件需先通过 OSS 上传接口上传后获得 object_key。 - 地图 > 地图标注 > 自定义图标 [删除自定义点位图标](https://henvmbbf6x.apifox.cn/470807882e0.md): 按 icon_id 删除图标的注册记录;仅删除数据库注册记录,不删除 OSS 中的实际文件。 - 地图 > 信号热力图 [查询组织级信号热力图](https://henvmbbf6x.apifox.cn/470807883e0.md): 按设备 SN 列表查询当前组织下用户有权限的所有项目的设备信号热力图。请求体与项目级接口相同。 - 地图 > 信号热力图 [查询项目级信号热力图](https://henvmbbf6x.apifox.cn/470807884e0.md): 按设备 SN 列表查询某项目下飞机历史飞行经过区域的信号强度热力图(H3 索引网格聚合,按 SDR / 4G 链路返回)。 device_sns 最多 3000 个,超出会被服务端截断并记录警告(不报错)。 - 地图 > 空域安全 > 自定义飞行区 [查询项目下的飞行区域列表](https://henvmbbf6x.apifox.cn/470807885e0.md): 查询某项目下所有自定义飞行区(电子围栏/禁飞区/禁降区),支持按名称、类型、状态过滤 + 分页。 - 地图 > 空域安全 > 自定义飞行区 [创建飞行区域](https://henvmbbf6x.apifox.cn/470807886e0.md): 在项目下创建一个自定义飞行区(按几何形状:圆 / 多边形 / 折线 + 限制类型)。 - 地图 > 空域安全 > 自定义飞行区 [触发飞行区配置同步到设备](https://henvmbbf6x.apifox.cn/470807887e0.md): 触发当前项目的飞行区配置下发到指定设备列表(设备会拉取最新配置)。⚠️ 注意本接口是 application/json,不是 multipart/form-data 文件上传——`upload` 指的是配置上传到设备而非客户端传文件。 - 地图 > 空域安全 > 自定义飞行区 [删除飞行区域](https://henvmbbf6x.apifox.cn/470807888e0.md): 删除指定飞行区。 - 地图 > 空域安全 > 自定义飞行区 [更新飞行区域](https://henvmbbf6x.apifox.cn/470807889e0.md): 更新飞行区的部分属性(名称 / 状态 / 类型 / 几何内容);用 area_hash 做乐观锁冲突检测。 - 地图 > 离线地图 [获取离线地图地表模型下载 URL](https://henvmbbf6x.apifox.cn/470807890e0.md): 按 Dock SN 获取离线地图地表模型文件的 OSS 签名下载 URL。若该 dock 尚未配置离线地图,data 会包含 disable: true。 - 地图 > 离线地图 [触发离线地图包同步到机库](https://henvmbbf6x.apifox.cn/470807891e0.md): 触发已配置的离线地图包同步到指定机库(Dock)。需先用配置离线地图清单接口配置后再触发同步。 - 地图 > 离线地图 [获取项目离线地图详情](https://henvmbbf6x.apifox.cn/470807892e0.md): 查询当前项目的离线地图详情:包含的 2D / 3D 模型列表、转换进度百分比、状态。 若未配置离线地图,data 会包含 disable: true。 - 地图 > 离线地图 [配置项目离线地图清单(启动新一次更新)](https://henvmbbf6x.apifox.cn/470807893e0.md): 配置项目的离线地图清单(指定要包含哪些 2D / 3D 模型),并启动新一次转换流程。配置后服务端进入转换队列:unknown → processing → success / failed,可用 GET offline-maps 接口轮询进度。 model_2d_items 和 model_3d_items 至少需要配一个。 - 地图 > 离线地图 [取消离线地图模型更新](https://henvmbbf6x.apifox.cn/470807894e0.md): 取消正在进行的离线地图转换流程;仅对 processing / pending 状态有效。已生成的包不会同步到设备,状态变为 failed(reason: user_cancelled)。 - 直播 > 直播分享与转发 > 旁路推流 [创建 / 开启 / 关闭 / 更新码流转发器](https://henvmbbf6x.apifox.cn/470807896e0.md): 该接口根据 Body 内容执行四种操作: - 直播 > 直播分享与转发 > 旁路推流 [查询当前组织的旁路转码器列表](https://henvmbbf6x.apifox.cn/470807895e0.md): 查询当前组织(按 X-Organization-Key 标识)下所有 C2C 旁路推流转码器。 - 直播 > 直播分享与转发 > 旁路推流 [停止并删除指定旁路转码器(C2C 直播旁路)](https://henvmbbf6x.apifox.cn/470807897e0.md): 停止指定转码器(converter_id)并删除其配置。 - 直播 > 直播分享与转发 > 直播分享 [获取设备直播分享详情](https://henvmbbf6x.apifox.cn/470807898e0.md): 按设备 SN 查询当前项目下该设备的直播分享详情;找不到返回 null。 - 直播 > 直播分享与转发 > 直播分享 [查询项目下所有直播分享链接](https://henvmbbf6x.apifox.cn/470807899e0.md): 返回当前项目下登录用户可访问的所有直播分享链接列表(仅含未过期、未取消且设备在该项目活跃集合内的)。 - 直播 > 直播推流 > 项目维度 [启动直播流(项目维度)](https://henvmbbf6x.apifox.cn/470807900e0.md): 项目维度启动飞行器直播推流,按 provider(agora/rtmp/火山等)选择推流引擎;返回拉流 URL 与过期时间戳。 - 直播 > 直播推流 > 项目维度 [更新观众 Token(项目维度](https://henvmbbf6x.apifox.cn/470807901e0.md): 为已加入直播房间的一批 web 观众批量刷新流引擎 access token(避免观众断流)。list 至少 1 项。 - 直播 > 直播推流 > 项目维度 [切换镜头(项目维度)](https://henvmbbf6x.apifox.cn/470807902e0.md): 向飞行器发送切换镜头(lens)指令,对应物理云台/相机的镜头切换。 - 直播 > 直播推流 > 项目维度 [切换直播相机(项目维度)](https://henvmbbf6x.apifox.cn/470807903e0.md): 切换飞行器主推流相机(多相机机型,如 H30 / M3D 系列)。具体取值参考机型相机能力。 - 直播 > 直播推流 > 项目维度 [上报观众加入直播房间状态(项目维度)](https://henvmbbf6x.apifox.cn/470807904e0.md): 观众端加入直播房间后上报加入成功/失败,服务端据此更新房间观众计数。 - 直播 > 直播推流 > 项目维度 [停止直播流(项目维度)](https://henvmbbf6x.apifox.cn/470807905e0.md): 停止指定设备的直播推流。 - 直播 > 直播推流 > 项目维度 [设置直播质量(项目维度,飞行器源端推流档位)](https://henvmbbf6x.apifox.cn/470807906e0.md): 动态调整正在推流设备的视频清晰度,无需停止/重启推流。 - 直播 > 直播推流 > 项目维度 [查询设备直播与录制状态(项目维度)](https://henvmbbf6x.apifox.cn/470807907e0.md): 聚合查询某设备当前的直播推流和录制任务状态;响应包含 created_by 等用户信息。 - 直播 > 直播推流 > 组织维度 [停止直播流(组织维度)](https://henvmbbf6x.apifox.cn/470807908e0.md): 停止指定设备的直播推流。 - 直播 > 直播推流 > 组织维度 [设置直播质量(组织维度,飞行器源端推流档位)](https://henvmbbf6x.apifox.cn/470807909e0.md): 动态调整正在推流设备的视频清晰度,无需停止/重启推流。 - 直播 > 直播推流 > 组织维度 [上报观众加入直播房间状态(组织维度)](https://henvmbbf6x.apifox.cn/470807910e0.md): 观众端加入直播房间后上报加入成功/失败,服务端据此更新房间观众计数。 - 直播 > 直播推流 > 组织维度 [启动直播流(组织维度)](https://henvmbbf6x.apifox.cn/470807911e0.md): 组织维度启动飞行器直播推流,按 provider 选择推流引擎;返回拉流 URL 与过期时间戳。功能与项目维度启动直播流接口相同,区别在于资源标识使用 org_uuid。 - 直播 > 直播推流 > 组织维度 [切换镜头(组织维度,同时控制飞行器源端硬件)](https://henvmbbf6x.apifox.cn/470807912e0.md): 向飞行器发送切换镜头(lens)指令,对应物理云台/相机的镜头切换。 - 直播 > 直播推流 > 组织维度 [更新观众 Token(组织维度)](https://henvmbbf6x.apifox.cn/470807913e0.md): 为已加入直播房间的一批 web 观众批量刷新流引擎 access token;list 至少 1 项。 - 直播 > 直播推流 > 组织维度 [切换直播相机(组织维度)](https://henvmbbf6x.apifox.cn/470807914e0.md): 切换飞行器主推流相机(多相机机型)。 - 直播 > 录制任务管理 [开始云端录制(项目维度)](https://henvmbbf6x.apifox.cn/470807915e0.md): 启动飞行器直播流的云端录制;服务端从 file-storage 自动获取存储 STS,**客户端无需传 store_config**。 - 直播 > 录制任务管理 [停止云端录制(项目维度)](https://henvmbbf6x.apifox.cn/470807916e0.md): 停止指定设备的云端录制;返回录制任务 BID 用于后续查询。 - 直播 > 录制任务管理 [查询设备录制任务列表(项目维度)](https://henvmbbf6x.apifox.cn/470807917e0.md): 查询指定设备在 drc service 中登记的所有录制任务。 - 直播 > 录制任务管理 [启动项目内直播流](https://henvmbbf6x.apifox.cn/470807918e0.md): 启动项目内直播流;新业务建议使用 drc 版接口(启动直播流)。 - 直播 > 录制任务管理 [查询设备录制任务列表(组织维度)](https://henvmbbf6x.apifox.cn/470807919e0.md): 查询指定设备登记的所有录制任务。 - 直播 > 录制任务管理 [开始云端录制(组织维度)](https://henvmbbf6x.apifox.cn/470807920e0.md): 启动飞行器云端录制;服务端从 file-storage 自动获取存储 STS,**客户端无需传 store_config**。 - 直播 > 录制任务管理 [停止云端录制(组织维度)](https://henvmbbf6x.apifox.cn/470807921e0.md): 停止指定设备的云端录制;返回录制任务 BID 用于后续查询。 - 直播 > 录制任务管理 [停止项目内直播录制](https://henvmbbf6x.apifox.cn/470807922e0.md): 停止指定设备的云端录制;响应为透传结果(含录制任务 bid)。新业务建议使用 drc 版接口(停止云端录制)。 - 媒体 > 飞行任务关联 [按 flight_id 查飞行任务媒体](https://henvmbbf6x.apifox.cn/470807923e0.md): 按 flight_id 查询某次飞行任务采集的媒体资源(图片或视频),用于飞行结束后调出该次飞行的产出。 - 媒体 > 飞行任务关联 [批量按 flight_ids 查飞行媒体](https://henvmbbf6x.apifox.cn/470807924e0.md): 一次按多个 flight_id 查询飞行任务媒体;返回二维数组结构(外层对应 flight_id,内层为该飞行的媒体条目),避免循环单查。 - 媒体 > 文件统计与查询 [获取媒体文件计数(按文件夹粒度)](https://henvmbbf6x.apifox.cn/470807925e0.md): 按父文件夹 + 文件类型过滤统计媒体文件数量,用于文件夹层级的角标数字显示。 - 媒体 > 文件统计与查询 [获取媒体文件总数(项目全量)](https://henvmbbf6x.apifox.cn/470807926e0.md): 按文件类型过滤统计当前项目媒体总数(项目级而非按文件夹) - 媒体 > 文件统计与查询 [获取媒体资源文件(图 + 文件夹)](https://henvmbbf6x.apifox.cn/470807927e0.md): 媒体库的统一资源列表接口;service 强制 file_types=[image, dir],仅返回图片和文件夹(不返回视频);适用于做高级筛选(移动场景、复杂多过滤)。与简化版 GET /files 区分。 - 媒体 > 媒体文件 CRUD [批量设置媒体地图显示状态](https://henvmbbf6x.apifox.cn/470807928e0.md): 批量把若干媒体文件设为「在地图上显示」或「不显示」(用于地图叠加显示拍摄点位)。支持按 ID 列表精确处理,或全选 + 过滤条件批量处理。 - 媒体 > 媒体文件 CRUD [批量删除媒体文件 -进回收站](https://henvmbbf6x.apifox.cn/470807929e0.md): 批量软删除媒体文件 / 文件夹,删除后进入回收站;支持按 ID 或全选过滤条件批量处理。请求被接收后立即返回 200,删除在后台异步执行;客户端通过列表接口确认结果。 - 媒体 > 媒体文件 CRUD [创建媒体文件夹](https://henvmbbf6x.apifox.cn/470807930e0.md): 在媒体库中创建一个文件夹(file_type=1)用于组织媒体层级。 > 此接口支持多种操作模式:创建文件夹时返回 `{id}`,查询文件列表时返回带分页的文件数组。 - 媒体 > 媒体文件 CRUD [获取媒体文件列表](https://henvmbbf6x.apifox.cn/470807931e0.md): 媒体库主列表接口,支持按文件类型组合、地图显示、文件夹层级、关键字、设备/负载机型、时间范围、标签、任务类型等多维度过滤。 - 媒体 > 媒体文件 CRUD [媒体文件裁剪](https://henvmbbf6x.apifox.cn/470807932e0.md): 把指定媒体图片按用户框选的矩形区域生成一张新的子图片,用于 AI 任务样片标注。 - 媒体 > 媒体文件 CRUD [批量移动媒体文件](https://henvmbbf6x.apifox.cn/470807933e0.md): 把若干媒体文件 / 文件夹移动到目标父文件夹下;支持按 ID 列表精确移动或全选 + 过滤条件批量移动。 - 媒体 > 媒体文件 CRUD [删除单个媒体文件](https://henvmbbf6x.apifox.cn/470807934e0.md): 删除指定单个媒体文件。默认软删进回收站;通过 destroy=true 直接永久删除。 - 媒体 > 媒体文件 CRUD [获取媒体文件详情](https://henvmbbf6x.apifox.cn/470807935e0.md): 根据媒体文件 ID 获取详情:基础属性 / EXIF / GPS / 拍摄设备 / 标签 / 分享状态 / AI 视频处理状态 / 全景图切片状态等。 - 媒体 > 媒体文件 CRUD [更新媒体文件信息](https://henvmbbf6x.apifox.cn/470807936e0.md): 更新单个媒体文件的元信息:改名 / 权限位 / 标签 / 上图开关 / 从回收站恢复等。 - 媒体 > 媒体文件 CRUD [批量硬删媒体文件-不进回收站](https://henvmbbf6x.apifox.cn/470807937e0.md): 批量直接从存储中永久删除媒体文件(不进回收站,不可恢复)。请求被接收后立即返回 200,实际删除在后台异步执行。 - 媒体 > 下载与上传 [快速上传媒体文件](https://henvmbbf6x.apifox.cn/470807938e0.md): 对于 OSS 已存在相同指纹的文件,跳过实际上传,直接登记记录到媒体库(秒传)。 - 媒体 > 下载与上传 [导入媒体文件](https://henvmbbf6x.apifox.cn/470807939e0.md): 从外部源(如 datahub 数据集 / AI 任务工作流节点)导入媒体文件到当前项目媒体库。 - 媒体 > 下载与上传 [检查新文件指纹存在状态](https://henvmbbf6x.apifox.cn/470807940e0.md): 上传新文件前用小指纹批量查重;返回服务端已存在的指纹集合,前端做差集决定上传哪些文件。 - 媒体 > 下载与上传 [涂鸦回调](https://henvmbbf6x.apifox.cn/470807941e0.md): 客户端把对图片做的涂鸦标注图层(含若干涂鸦项)上传到 OSS 后调本接口登记到媒体库。 - 媒体 > 下载与上传 [媒体上传完成回调](https://henvmbbf6x.apifox.cn/470807942e0.md): 客户端把媒体文件直传到 OSS 后调本接口登记媒体元信息(EXIF / GPS / 拍摄设备 / 关联飞行任务等),完成入库。 - 媒体 > 下载与上传 [检查 zip 打包任务状态](https://henvmbbf6x.apifox.cn/470807943e0.md): 查询批量打包 zip 任务的状态,用于决定下载方式(单包 vs 分块)。 - 媒体 > 下载与上传 [打包媒体文件为 zip](https://henvmbbf6x.apifox.cn/470807944e0.md): 把若干媒体文件 / 文件夹打包成 zip 后存到 OSS,可批量下载。生成 zip 是异步任务,可通过 zip-check 接口查进度。 - 媒体 > 下载与上传 [获取媒体文件下载 URL](https://henvmbbf6x.apifox.cn/470807945e0.md): 获取指定媒体文件的 OSS 签名下载 URL;服务端通过 302 重定向直接跳转到 OSS(响应不返回业务 JSON)。支持图片缩放参数(w/h/q)和 AI 视频版本切换。 - 媒体 > 标签管理 [为媒体文件添加标签](https://henvmbbf6x.apifox.cn/470807946e0.md): 为指定媒体文件添加一个或多个标签;标签可用于后续筛选。 - 媒体 > 标签管理 [删除媒体文件标签](https://henvmbbf6x.apifox.cn/470807947e0.md): 从指定媒体文件上移除一个标签(form 参数 tag_name,单值)。 - 媒体 > 标签管理 [获取项目下的媒体文件标签列表](https://henvmbbf6x.apifox.cn/470807948e0.md): 查询当前项目已使用的所有媒体文件标签,用于标签筛选 / 自动补全建议。 - 模型 > 模型重建 [获取飞行任务文件夹列表 V2](https://henvmbbf6x.apifox.cn/470807949e0.md): 按航线(wayline_uuid)查询关联的媒体文件夹列表,含期望文件数 / 已上传文件数 / 上传完成状态。 - 模型 > 模型重建 [获取实时建图任务列表](https://henvmbbf6x.apifox.cn/470807950e0.md): 查询当前项目的所有实时建图(Realtime2D)任务列表,支持按状态、名称、UUID 过滤。返回带任务状态、进度、覆盖区域等元数据的 Job 对象列表。 - 模型 > 模型重建 [发起实时建图任务(Realtime2D)](https://henvmbbf6x.apifox.cn/470807951e0.md): 发起一个实时建图(Realtime2D)任务(飞行过程中边飞边建图)。服务端返回 OSS 上传 STS 凭证供图源上传 + 启动后的 Job 信息 + 资源信息。 注:与后处理重建(「发起后处理重建任务(Post 2D / 3D)」接口)不同,本接口走 reconstruction svc,用于 Realtime2D 业务分层。 - 模型 > 模型重建 [获取项目模型库默认设置](https://henvmbbf6x.apifox.cn/470807952e0.md): 查询项目的默认坐标系(WKT 格式),用于模型格式转换和后处理重建任务的坐标系参数。 - 模型 > 模型重建 [发起后处理重建任务(Post 2D / 3D)](https://henvmbbf6x.apifox.cn/470807953e0.md): 基于已上传的媒体素材发起后处理重建任务(2D 或 3D),可指定输出格式 / 质量级别 / 兴趣区域 / 像控点 / 坐标系。 业务约束:同一模型库文件不允许并发重建任务。 - 模型 > 模型重建 [获取后重建默认兴趣区域](https://henvmbbf6x.apifox.cn/470807954e0.md): 根据指定的媒体文件夹列表计算并返回默认兴趣区域(媒体覆盖范围的凸包),用于后重建任务中指定处理范围。 - 模型 > 模型重建 [获取后重建质量报告下载链接](https://henvmbbf6x.apifox.cn/470807955e0.md): 获取已完成的后处理重建任务的质量报告下载链接(含重建质量评估、检查点 / 控制点误差、空三精度)。 - 模型 > 模型重建 [后重建任务重试](https://henvmbbf6x.apifox.cn/470807956e0.md): 对失败状态的后重建任务进行重试;使用原任务的重建参数和配置重新启动。停止状态的任务不可重试。 - 模型 > 模型重建 [停止后重建任务](https://henvmbbf6x.apifox.cn/470807957e0.md): 停止运行中的后重建任务;任务状态变为 stopped,已生成的中间结果保留。停止后不可再重试。 - 模型 > 模型重建 [模型上传完成回调(客户端调用,非 OSS 验签)](https://henvmbbf6x.apifox.cn/470807958e0.md): 客户端用 STS 凭证将模型文件直传 OSS 后调用本接口通知服务端登记入库(含父目录、是否上图、文件类型等)。私有化场景跳过付费校验,公有云走存储资源校验。 - 模型 > 模型重建 [查询可用于模型重建的航线列表](https://henvmbbf6x.apifox.cn/470807959e0.md): 查询当前项目可用于模型重建的航线列表(含名称、模板类型、最近飞行时间、GSD 等)。 - 模型 > 模型库 > 模型文件管理 [批量删除模型文件](https://henvmbbf6x.apifox.cn/470807960e0.md): 批量删除模型文件;锁定的文件会拒绝(返回 PermissionDenied)。可指定 ids 精选删除,或 selected_parent_id + 筛选条件全选删除。 - 模型 > 模型库 > 模型文件管理 [获取项目模型文件列表](https://henvmbbf6x.apifox.cn/470807961e0.md): 查询项目模型文件列表,支持搜索、分页、按文件类型/模型状态/分享状态过滤。 - 模型 > 模型库 > 模型文件管理 [创建模型文件夹](https://henvmbbf6x.apifox.cn/470807962e0.md): 创建模型文件夹(仅文件夹,不支持上传文件)。 - 模型 > 模型库 > 模型文件管理 [批量切换模型上图状态](https://henvmbbf6x.apifox.cn/470807963e0.md): 批量切换模型在地图上的显示/隐藏 + 分发 + 显示模式 + 高度模式等多个属性。show_on_map 为 null 时跳过权限检查。ids 与 select_filter 二选一。 - 模型 > 模型库 > 模型文件管理 [锁定 / 解锁模型文件](https://henvmbbf6x.apifox.cn/470807964e0.md): 锁定指定模型文件防止删除;锁定的文件不能被删除。 - 模型 > 模型库 > 模型文件管理 [批量移动模型文件](https://henvmbbf6x.apifox.cn/470807965e0.md): 批量移动模型文件到目标父文件夹。可用 ids 精选移动,或 selected_parent_id + 筛选条件全选移动。若 ids 非空则忽略 selected_parent_id。 - 模型 > 模型库 > 模型文件管理 [组织内模型共享](https://henvmbbf6x.apifox.cn/470807966e0.md): 把当前项目下的若干模型文件共享给组织内其他项目 - 模型 > 模型库 > 模型文件管理 [获取模型文件总数](https://henvmbbf6x.apifox.cn/470807967e0.md): 在当前筛选条件下统计模型文件总数。筛选条件与项目模型文件列表接口(「获取项目模型文件列表」接口)共享同一 DTO。 - 模型 > 模型库 > 模型文件管理 [删除单个模型文件](https://henvmbbf6x.apifox.cn/470807968e0.md): 删除单个模型文件;锁定的文件返回 PermissionDenied。支持回收站删除(默认)和永久删除两种模式。 - 模型 > 模型库 > 模型文件管理 [获取模型文件详情](https://henvmbbf6x.apifox.cn/470807969e0.md): 获取模型文件完整详情,包含建图元数据(覆盖面积 / GSD / 图源张数)、坐标系、显示属性等。 - 模型 > 模型库 > 模型文件管理 [更新模型基本信息](https://henvmbbf6x.apifox.cn/470807970e0.md): 更新模型基本信息(名称 / 高度模式 / 显示模式 / 采集时间);name 不允许包含 /。 - 模型 > 模型库 > 模型文件管理 [获取模型文件下载 URL](https://henvmbbf6x.apifox.cn/470807971e0.md): 获取模型文件的 OSS 签名下载 URL。type 默认为 1(标准下载链接)。 - 模型 > 模型库 > 模型文件管理 [发起模型格式 / 坐标系转换任务](https://henvmbbf6x.apifox.cn/470807972e0.md): 将一个已完成的 3D / 2D 模型转换为指定坐标系(WKT 格式)。目标 WKT 必须来自坐标系列表接口(「获取项目可用的坐标系(WKT)列表」接口)返回的可用值。 - 模型 > 模型库 > 模型文件管理 [获取项目可用的坐标系(WKT)列表](https://henvmbbf6x.apifox.cn/470807973e0.md): 返回当前项目可用的所有坐标系(WKT 字符串列表),分投影坐标系与地心坐标系两类。每个坐标系含 name 和 wkt 字段,可用于发起模型格式转换接口(「发起模型格式 / 坐标系转换任务」接口)。 - 模型 > 模型库 > 地图展示 [批量设置实时建图模型的地形加载状态](https://henvmbbf6x.apifox.cn/470807974e0.md): 批量设置多个实时建图任务的地形加载状态,用于地图展示页的批量操作。 - 模型 > 模型库 > 地图展示 [调整实时建图模型展示顺序(拖拽排序)](https://henvmbbf6x.apifox.cn/470807975e0.md): 拖拽排序时调整一组实时建图模型在地图上的展示顺序。 - 模型 > 模型库 > 地图展示 [更新建图任务元属性(改名 / 显隐 / 分发 / 取消分发 / 切换地形)](https://henvmbbf6x.apifox.cn/470807976e0.md): 更新单个实时建图任务的元属性(名称、显示/隐藏、分发/取消分发、地形加载状态)。仅可修改已完成(status=3)或已失败(status=4)的任务。 - 模型 > 模型库 > 地图展示 [获取地图页模型图层列表](https://henvmbbf6x.apifox.cn/470807977e0.md): 查询当前项目可用于地图展示的模型图层列表(来自 Post 后处理重建结果)。支持按状态、是否分发、文件类型过滤。 - 模型 > 模型库 > 地图展示 [批量切换地图模型图层属性](https://henvmbbf6x.apifox.cn/470807978e0.md): 批量切换 Post 后处理重建模型在地图页的显示/隐藏 + 地形加载状态。show_on_map / elevation_load_status 至少一个有值。 - 模型 > 模型库 > 地图展示 [调整地图模型图层叠加顺序](https://henvmbbf6x.apifox.cn/470807979e0.md): 调整 Post 后处理重建模型在地图页的图层叠加顺序(拖拽排序)。 - 开放建模 [获取正在重建中的模型详情](https://henvmbbf6x.apifox.cn/472408149e0.md): 获取正在重建中模型详情。 **model status 枚举** - 开放建模 [获取资源详情](https://henvmbbf6x.apifox.cn/472408150e0.md): 获取资源详情,用于查询资源状态和大小。 **resource status 枚举** - 开放建模 [删除资源](https://henvmbbf6x.apifox.cn/472408151e0.md): 删除资源,用于删除上传的资源,释放存储空间。 - 开放建模 [获取上传凭证](https://henvmbbf6x.apifox.cn/472408152e0.md): 获取上传凭证,用于上传文件到云存储。 - 开放建模 [开始重建任务](https://henvmbbf6x.apifox.cn/472408153e0.md): 1. 开始重建任务,用于开始重建任务,可同时建多种类型的模型,但至少需要传一种 `parameter_` 参数。 - 开放建模 [上传回调](https://henvmbbf6x.apifox.cn/472408154e0.md): 上传回调,用于上传文件后,通知需要复制的文件资源有哪些。 - 开放建模 [停止重建任务](https://henvmbbf6x.apifox.cn/472408155e0.md): - 开放建模 [获取模型详情](https://henvmbbf6x.apifox.cn/472408156e0.md): 获取模型详情,用于查询模型状态、大小和任务进度。 **model status 枚举** - 开放建模 [删除模型](https://henvmbbf6x.apifox.cn/472408157e0.md): 删除模型,用于删除模型,释放存储空间,如果模型处理建模中,则也同步会停止建模。 - 回收站 [单条硬删媒体文件](https://henvmbbf6x.apifox.cn/470807980e0.md): 对单个媒体文件或文件夹直接从存储中永久删除(不进入回收站,不可恢复)。受保护的目录类型(直播录制目录、2D 实时建图目录、组织数据目录)不允许删除。 - 回收站 [从回收站恢复文件](https://henvmbbf6x.apifox.cn/470807981e0.md): 把回收站中的指定文件或文件夹批量恢复到原位置;如原父文件夹也被删除,则恢复到项目根目录。请求被接收后立即返回 200,实际恢复在后台异步执行;客户端无法通过响应判断最终成败,需要通过列表接口确认结果。 - 回收站 [永久删除回收站文件](https://henvmbbf6x.apifox.cn/470807982e0.md): 把回收站中的指定文件或文件夹批量从存储中永久删除(不可恢复)。请求被接收后立即返回 200,实际删除在后台异步执行;客户端无法通过响应判断最终成败,需要通过列表接口确认结果。 - 回收站 [获取媒体回收站文件列表](https://henvmbbf6x.apifox.cn/470807983e0.md): 查询当前项目媒体回收站中的文件列表,支持按文件名关键字过滤、按文件类型筛选、分页浏览,以及在已删文件夹内向下浏览子项。 - 回收站 [修改媒体回收站配置](https://henvmbbf6x.apifox.cn/470807984e0.md): 更新媒体回收站文件保留天数策略;超过该天数的文件将被自动永久清理。 - 回收站 [获取媒体回收站配置](https://henvmbbf6x.apifox.cn/470807985e0.md): 读取当前项目媒体回收站的自动清理策略,即文件在回收站中保留的最长天数。未设置过的项目返回默认值 30。 - 回收站 [获取模型库回收站磁盘统计](https://henvmbbf6x.apifox.cn/470807986e0.md): 按文件类型统计当前项目模型库回收站内的文件占用情况;返回总数、已用空间、剩余空间和按类型分组的明细。 - 回收站 [获取媒体回收站磁盘统计](https://henvmbbf6x.apifox.cn/470807987e0.md): 按文件类型统计当前项目媒体回收站内的文件占用情况;返回总数、已用空间、剩余空间和按类型分组的明细。 - 高级能力 > 变化检测 > 媒体变化检测 [发起媒体找不同任务](https://henvmbbf6x.apifox.cn/470807988e0.md): 基于两组照片(原始组 + 对比组)发起 AI 找不同检测任务,识别两次航拍之间的变化(如人 / 车 / 船等目标的新增或消失)。 - 高级能力 > 变化检测 > 媒体变化检测 [查询媒体找不同任务列表](https://henvmbbf6x.apifox.cn/470807989e0.md): 查询当前项目下的媒体找不同任务列表。 - 高级能力 > 变化检测 > 媒体变化检测 [删除找不同任务](https://henvmbbf6x.apifox.cn/470807990e0.md): 删除指定找不同任务及其所有差异结果数据。 - 高级能力 > 变化检测 > 媒体变化检测 [修改找不同任务名称等属性](https://henvmbbf6x.apifox.cn/470807991e0.md): 更新找不同任务的元信息(如改名)。 - 高级能力 > 变化检测 > 媒体变化检测 [获取找不同任务详情](https://henvmbbf6x.apifox.cn/470807992e0.md): 获取指定找不同任务的详情(含差异区域统计、结果组列表、任务状态等)。 - 高级能力 > 变化检测 > 媒体变化检测 [评价找不同任务](https://henvmbbf6x.apifox.cn/470807993e0.md): 用户对一个已完成的 AI 找不同任务做评价(1-5 星 + 关键词标签 + 文字评论 ≤ 500 字),用于产品做检测质量满意度采集与算法迭代。如果只传 status 表示用户主动关闭弹窗(还没真评价);如果传了 `rating_star ≠ 0` 则代表完成评价,自动把 status 置为 3(已评价完毕,不再弹窗)。 - 高级能力 > 变化检测 > 媒体变化检测 [批量修改找不同结果状态](https://henvmbbf6x.apifox.cn/470807994e0.md): 批量修改结果组的属性(如批量标记为"人为审核确认" / "误报排除")。 - 高级能力 > 变化检测 > 媒体变化检测 [删除变化区域](https://henvmbbf6x.apifox.cn/470807995e0.md): 删除指定差异区域。 - 高级能力 > 变化检测 > 媒体变化检测 [添加变化区域(人工标注)](https://henvmbbf6x.apifox.cn/470807996e0.md): 在结果组中手工添加一个差异区域。 - 高级能力 > 变化检测 > 媒体变化检测 [更新变化区域属性](https://henvmbbf6x.apifox.cn/470807997e0.md): 更新指定差异区域的属性(如类别 / 颜色 / 描述 / 是否人工确认)。 - 高级能力 > 变化检测 > 媒体变化检测 [获取媒体上传 STS 凭证](https://henvmbbf6x.apifox.cn/470807998e0.md): 获取媒体直传 OSS 的 STS 临时凭证。客户端拿到后直接 PUT 文件到 OSS,再调 upload-callback 登记。 - 高级能力 > 变化检测 > 媒体变化检测 [媒体找不同任务预检](https://henvmbbf6x.apifox.cn/470807999e0.md): 在创建找不同任务前,对两组照片做图像匹配预检(如分辨率 / 视角 / 重合度),返回是否适合做对比。 - 高级能力 > 变化检测 > 媒体变化检测 [查看找不同检测报告](https://henvmbbf6x.apifox.cn/470808000e0.md): 获取找不同任务的检测报告(PDF / HTML 格式)。 - 高级能力 > 变化检测 > 媒体变化检测 [获取照片组 AI 找不同结果列表](https://henvmbbf6x.apifox.cn/470808001e0.md): 查询找不同任务的结果组列表(按照片对分组,每组包含若干差异区域)。 - 高级能力 > 变化检测 > 媒体变化检测 [获取结果组中的变化区域详情](https://henvmbbf6x.apifox.cn/470808002e0.md): 获取指定结果组中的所有差异区域详情(含位置 / 类别 / 颜色 / 描述)。 - 高级能力 > 变化检测 > 模型变化检测 [发起模型对比任务(找不同)](https://henvmbbf6x.apifox.cn/470808003e0.md): 基于两个三维模型(基准模型 + 对比模型)发起一次"找不同"AI 检测任务,识别两次建模之间的变化(如新增 / 消失的物体)。任务异步执行,通过 list / detail 接口轮询结果。 - 高级能力 > 变化检测 > 模型变化检测 [查询模型对比任务列表](https://henvmbbf6x.apifox.cn/470808004e0.md): 查询当前项目下的模型对比任务列表,支持按名称 / 时间段 / 关联航线过滤。 - 高级能力 > 变化检测 > 模型变化检测 [修改模型对比任务名称等属性](https://henvmbbf6x.apifox.cn/470808005e0.md): 更新指定模型对比任务的元信息(如改名)。 - 高级能力 > 变化检测 > 模型变化检测 [获取模型对比任务结果详情](https://henvmbbf6x.apifox.cn/470808006e0.md): 获取指定模型对比任务的结果详情:任务状态 / 进度 / 差异区域列表 / 已生成的检测报告状态。 - 高级能力 > 变化检测 > 模型变化检测 [删除模型对比任务](https://henvmbbf6x.apifox.cn/470808007e0.md): 删除指定模型对比任务及其差异区域结果数据。 - 高级能力 > 变化检测 > 模型变化检测 [批量更新模型对比差异](https://henvmbbf6x.apifox.cn/470808008e0.md): 批量修改对比任务中若干差异区域的属性(如标注为"人为审核确认" / "误报排除" / 改描述)。 - 高级能力 > 变化检测 > 模型变化检测 [删除模型对比差异](https://henvmbbf6x.apifox.cn/470808009e0.md): 删除对比任务中指定的差异区域。 - 高级能力 > 变化检测 > 模型变化检测 [添加模型对比差异(人工标注)](https://henvmbbf6x.apifox.cn/470808010e0.md): 在对比任务中手工添加一个差异区域(用于补充 AI 没识别到的变化)。 - 高级能力 > 变化检测 > 模型变化检测 [更新模型对比单个差异详情](https://henvmbbf6x.apifox.cn/470808011e0.md): 更新指定差异区域的属性(如描述、范围、是否人为变更等)。 - 高级能力 > 变化检测 > 模型变化检测 [获取模型对比检测报告](https://henvmbbf6x.apifox.cn/470808012e0.md): 获取对比任务的检测报告(PDF 格式,多语言版本)。返回 OSS 签名 URL 供下载。 - 高级能力 > 变化检测 > 模型变化检测 [查询适合做模型对比的候选模型](https://henvmbbf6x.apifox.cn/470808013e0.md): 基于指定模型推荐可用于"找不同"对比的其他模型(按时间相近、覆盖区域相近、来源航线一致等维度排序)。 - 高级能力 > 变化检测 > 模型变化检测 [评价模型对比任务](https://henvmbbf6x.apifox.cn/470808014e0.md): 用户对一个已完成的模型 AI 找不同任务做评价(1-5 星 + 关键词标签 + 文字评论 ≤ 500 字),用于产品做检测质量满意度采集与算法迭代。如果只传 status 表示用户主动关闭弹窗(还没真评价);如果传了 `rating_star ≠ 0` 则代表完成评价,自动把 status 置为 3(已评价完毕,不再弹窗)。与媒体找不同接口共用评价逻辑,通过 task_uuid 关联(UUID 全局唯一)。 ## Schemas - 默认目录 [StsCredentials](https://henvmbbf6x.apifox.cn/283072851d0.md): - 默认目录 [ProjectShareLinkDetail](https://henvmbbf6x.apifox.cn/283073045d0.md): - 默认目录 [DrcStartStreamResp](https://henvmbbf6x.apifox.cn/283073047d0.md): - 默认目录 [PutWorkspacesWaylinesBatchDeleteResp](https://henvmbbf6x.apifox.cn/283073050d0.md): - 默认目录 [PutWorkspacesWaylinesLockStatusResp](https://henvmbbf6x.apifox.cn/283073056d0.md): - 默认目录 [GetWorkspacesOfflineMapsUrlResp](https://henvmbbf6x.apifox.cn/283073060d0.md): - 默认目录 [GetWorkspacesOfflineMapsResp](https://henvmbbf6x.apifox.cn/283073062d0.md): - 默认目录 [GetWorkspacesAirSenseWarningsResp](https://henvmbbf6x.apifox.cn/283073065d0.md): - 默认目录 [PostCommonWeatherReportResp](https://henvmbbf6x.apifox.cn/283073066d0.md): - 默认目录 [GetWorkspacesWebWaylinesResp](https://henvmbbf6x.apifox.cn/283073070d0.md): - 默认目录 [PostFlightTasksAdvancedReq](https://henvmbbf6x.apifox.cn/283073071d0.md): - 默认目录 [C0034_ListOrgUsers_Resp](https://henvmbbf6x.apifox.cn/283073077d0.md): - 默认目录 [C0038_GetProjectUserPermissionTree_Resp](https://henvmbbf6x.apifox.cn/283073078d0.md): - 默认目录 [C0030_ListProjectIndividuals_Resp](https://henvmbbf6x.apifox.cn/283073079d0.md): - 默认目录 [C0031_ListProjectUsers_Resp](https://henvmbbf6x.apifox.cn/283073080d0.md): - 默认目录 [C0095_Op_Resp](https://henvmbbf6x.apifox.cn/283073081d0.md): - 默认目录 [C0096_HMS_get_Resp](https://henvmbbf6x.apifox.cn/283073082d0.md): - 默认目录 [C0077_Op_get_Resp](https://henvmbbf6x.apifox.cn/283073083d0.md): - 默认目录 [C0058_Op_Resp](https://henvmbbf6x.apifox.cn/283073091d0.md): - 默认目录 [C0575_GetHistory_Resp](https://henvmbbf6x.apifox.cn/283073092d0.md): - 默认目录 [C0564_GetTopologies_Resp](https://henvmbbf6x.apifox.cn/283073093d0.md): - 默认目录 [C0580_GetInFlight_Resp](https://henvmbbf6x.apifox.cn/283073098d0.md): - 默认目录 [C0160_GetFlightTaskAdvanced_Resp](https://henvmbbf6x.apifox.cn/283073105d0.md): - 默认目录 [C0617_GetFlightTasks_Resp](https://henvmbbf6x.apifox.cn/283073106d0.md): - 默认目录 [StsResult](https://henvmbbf6x.apifox.cn/283072852d0.md): - 默认目录 [C0619_CreateBatchDownload_Resp](https://henvmbbf6x.apifox.cn/283073110d0.md): - 默认目录 [FlightOperationVO](https://henvmbbf6x.apifox.cn/283072856d0.md): - 默认目录 [FlightTask](https://henvmbbf6x.apifox.cn/283072859d0.md): - 默认目录 [C0253_get_convertersVolcList_Resp](https://henvmbbf6x.apifox.cn/283073118d0.md): - 默认目录 [User](https://henvmbbf6x.apifox.cn/283072866d0.md): - 默认目录 [C0587_CreateStreamsSwitch_Resp](https://henvmbbf6x.apifox.cn/283073123d0.md): - 默认目录 [C0589_GetTopologiesCmds_Resp](https://henvmbbf6x.apifox.cn/283073124d0.md): - 默认目录 [C0604_GetRecordDevice_Resp](https://henvmbbf6x.apifox.cn/283073129d0.md): - 默认目录 [C0607_GetRecordDevice_Resp](https://henvmbbf6x.apifox.cn/283073133d0.md): - 默认目录 [GetWorkspacesFilesCompareFilesResp](https://henvmbbf6x.apifox.cn/283073135d0.md): - 默认目录 [DeviceModelInfo](https://henvmbbf6x.apifox.cn/283073136d0.md): - 默认目录 [DeviceState_drone_other](https://henvmbbf6x.apifox.cn/283073137d0.md): - 默认目录 [DeviceState_ea210dock](https://henvmbbf6x.apifox.cn/283073138d0.md): - 默认目录 [Position](https://henvmbbf6x.apifox.cn/283072883d0.md): - 默认目录 [DeviceState_ea210drone](https://henvmbbf6x.apifox.cn/283073139d0.md): - 默认目录 [ProjectTeamGetDevicesRspItem](https://henvmbbf6x.apifox.cn/283072884d0.md): - 默认目录 [DeviceState_ea220dock](https://henvmbbf6x.apifox.cn/283073140d0.md): - 默认目录 [ProjectTeamGetDevicesRspItemBaseTopo](https://henvmbbf6x.apifox.cn/283072885d0.md): - 默认目录 [DeviceState_ea220drone](https://henvmbbf6x.apifox.cn/283073141d0.md): - 默认目录 [DeviceState_ea230dock](https://henvmbbf6x.apifox.cn/283073142d0.md): - 默认目录 [DeviceModelEnum](https://henvmbbf6x.apifox.cn/283072887d0.md): - 默认目录 [DeviceState_ea230drone](https://henvmbbf6x.apifox.cn/283073143d0.md): - 默认目录 [DeviceState_rc510](https://henvmbbf6x.apifox.cn/283073144d0.md): - 默认目录 [DeviceState_rc701](https://henvmbbf6x.apifox.cn/283073145d0.md): - 默认目录 [DeviceState_rc_other](https://henvmbbf6x.apifox.cn/283073146d0.md): - 默认目录 [DeviceState_wa345](https://henvmbbf6x.apifox.cn/283073147d0.md): - 默认目录 [DeviceState_wm265](https://henvmbbf6x.apifox.cn/283073148d0.md): - 默认目录 [StartStreamResp](https://henvmbbf6x.apifox.cn/283072903d0.md): - 默认目录 [Device](https://henvmbbf6x.apifox.cn/283072915d0.md): - 默认目录 [Project](https://henvmbbf6x.apifox.cn/283072919d0.md): - 默认目录 [ProjectTeamGetDevicesRsp](https://henvmbbf6x.apifox.cn/283072924d0.md): - 默认目录 [StatisticsInfo](https://henvmbbf6x.apifox.cn/283072926d0.md): - 默认目录 [ChunkedFile](https://henvmbbf6x.apifox.cn/283072928d0.md): - 默认目录 [Ancestor](https://henvmbbf6x.apifox.cn/283072930d0.md): - 默认目录 [MediaFileItem](https://henvmbbf6x.apifox.cn/283072931d0.md): - 默认目录 [GetOrganizationsDevicesResp](https://henvmbbf6x.apifox.cn/283072933d0.md): - 默认目录 [GetOrganizationsManageDevicesResp](https://henvmbbf6x.apifox.cn/283072934d0.md): - 默认目录 [PostWorkspacesFlightTasksDeviceRecommendationResp](https://henvmbbf6x.apifox.cn/283072939d0.md): - 默认目录 [GetWorkspacesFlightTasksInFlightResp](https://henvmbbf6x.apifox.cn/283072944d0.md): - 默认目录 [PutWorkspacesReconstructionsResp](https://henvmbbf6x.apifox.cn/283072966d0.md): - 默认目录 [PutWorkspacesFlightAreasResp](https://henvmbbf6x.apifox.cn/283072969d0.md): - 默认目录 [GetProjectFlightAreasUrlResp](https://henvmbbf6x.apifox.cn/283072970d0.md): - 默认目录 [PutProjectFlightAreasResp](https://henvmbbf6x.apifox.cn/283072972d0.md): - 默认目录 [GetProjectFlightAreasResp](https://henvmbbf6x.apifox.cn/283072975d0.md): - 默认目录 [PostModelReconstructPreCheckResp](https://henvmbbf6x.apifox.cn/283072976d0.md): - 默认目录 [GetWorkspacesReconWaylinesResp](https://henvmbbf6x.apifox.cn/283072982d0.md): - 默认目录 [GetModelListFlightFoldersResp](https://henvmbbf6x.apifox.cn/283072983d0.md): - 默认目录 [GetModelListFlightFoldersV2Resp](https://henvmbbf6x.apifox.cn/283072984d0.md): - 默认目录 [GetWorkspacesDriveStatisticsResp](https://henvmbbf6x.apifox.cn/283072985d0.md): - 默认目录 [GetWorkspacesFilesResp](https://henvmbbf6x.apifox.cn/283072989d0.md): - 默认目录 [GetWorkspacesFilesUrlResp](https://henvmbbf6x.apifox.cn/283072990d0.md): - 默认目录 [PostWorkspacesFilesPreviewCallbackResp](https://henvmbbf6x.apifox.cn/283072993d0.md): - 默认目录 [GetDiffMediaListResp](https://henvmbbf6x.apifox.cn/283072996d0.md): - 默认目录 [PostWorkspacesStsResp](https://henvmbbf6x.apifox.cn/283073004d0.md): - 默认目录 [GetDiffModelListResp](https://henvmbbf6x.apifox.cn/283073005d0.md): - 默认目录 [GetWorkspacesDriveStatisticsTrashResp](https://henvmbbf6x.apifox.cn/283073012d0.md): - 默认目录 [GetWorkspacesMapsModelsResp](https://henvmbbf6x.apifox.cn/283073017d0.md): - 默认目录 [GetWorkspacesStsResp](https://henvmbbf6x.apifox.cn/283073019d0.md): - 默认目录 [GetWorkspacesResourcesResp](https://henvmbbf6x.apifox.cn/283073020d0.md): - 默认目录 [PostWorkspacesResourcesResp](https://henvmbbf6x.apifox.cn/283073021d0.md): - 默认目录 [PutWorkspacesResourcesResp](https://henvmbbf6x.apifox.cn/283073022d0.md): - 默认目录 [Operation](https://henvmbbf6x.apifox.cn/283072853d0.md): - 默认目录 [Exception](https://henvmbbf6x.apifox.cn/283072854d0.md): - 默认目录 [FlightReplay](https://henvmbbf6x.apifox.cn/283072855d0.md): - 默认目录 [ListTaskWayline](https://henvmbbf6x.apifox.cn/283072857d0.md): - 默认目录 [FolderUploadInfo](https://henvmbbf6x.apifox.cn/283072858d0.md): - 默认目录 [Resp](https://henvmbbf6x.apifox.cn/283072860d0.md): - 默认目录 [TaskType](https://henvmbbf6x.apifox.cn/283072861d0.md): - 默认目录 [FlightTaskType](https://henvmbbf6x.apifox.cn/283072862d0.md): - 默认目录 [TaskStatus](https://henvmbbf6x.apifox.cn/283072863d0.md): - 默认目录 [MediaPosition](https://henvmbbf6x.apifox.cn/283072864d0.md): - 默认目录 [ApiEnvelope](https://henvmbbf6x.apifox.cn/283072865d0.md): - 默认目录 [UserContactInformation](https://henvmbbf6x.apifox.cn/283072867d0.md): - 默认目录 [LiveTokenResult](https://henvmbbf6x.apifox.cn/283072868d0.md): - 默认目录 [OrganizationIndustryType](https://henvmbbf6x.apifox.cn/283072869d0.md): - 默认目录 [OrganizationUnitsConfig](https://henvmbbf6x.apifox.cn/283072870d0.md): - 默认目录 [OrganizationGeoCagingConfig](https://henvmbbf6x.apifox.cn/283072871d0.md): - 默认目录 [OrganizationDeviceBindCode](https://henvmbbf6x.apifox.cn/283072872d0.md): - 默认目录 [ProjectWorkCenterPoint](https://henvmbbf6x.apifox.cn/283072873d0.md): - 默认目录 [CloudWeatherBlockingConfig](https://henvmbbf6x.apifox.cn/283072874d0.md): - 默认目录 [weatherBlocking](https://henvmbbf6x.apifox.cn/283072875d0.md): - 默认目录 [AirportWeatherStationBlockingConfig](https://henvmbbf6x.apifox.cn/283072876d0.md): - 默认目录 [ProjectShareConfig](https://henvmbbf6x.apifox.cn/283072877d0.md): - 默认目录 [ProjectFastJoin](https://henvmbbf6x.apifox.cn/283072878d0.md): - 默认目录 [DeviceControlOperationReq](https://henvmbbf6x.apifox.cn/283072879d0.md): - 默认目录 [DeviceControlOperationRsp](https://henvmbbf6x.apifox.cn/283072880d0.md): - 默认目录 [DeviceHmsInfo](https://henvmbbf6x.apifox.cn/283072881d0.md): - 默认目录 [DeviceShadowsDesired](https://henvmbbf6x.apifox.cn/283072882d0.md): - 默认目录 [ProjectTeamUpdateDeviceShadowReq](https://henvmbbf6x.apifox.cn/283072886d0.md): - 默认目录 [DeviceTopo](https://henvmbbf6x.apifox.cn/283072888d0.md): - 默认目录 [TopoGatewayDevice](https://henvmbbf6x.apifox.cn/283072889d0.md): - 默认目录 [TopoNodeDevice](https://henvmbbf6x.apifox.cn/283072890d0.md): - 默认目录 [TopoHostDevice](https://henvmbbf6x.apifox.cn/283072891d0.md): - 默认目录 [ActionType](https://henvmbbf6x.apifox.cn/283072892d0.md): - 默认目录 [TargetType](https://henvmbbf6x.apifox.cn/283072893d0.md): - 默认目录 [AiLinkHeartBeatRequest](https://henvmbbf6x.apifox.cn/283072894d0.md): - 默认目录 [AiLinkStartStreamRequest](https://henvmbbf6x.apifox.cn/283072895d0.md): - 默认目录 [ChangeCameraStreamParam](https://henvmbbf6x.apifox.cn/283072896d0.md): - 默认目录 [CommonStreamStruct](https://henvmbbf6x.apifox.cn/283072897d0.md): - 默认目录 [RecordTask](https://henvmbbf6x.apifox.cn/283072898d0.md): - 默认目录 [RecordTaskList](https://henvmbbf6x.apifox.cn/283072899d0.md): - 默认目录 [SetQualityParam](https://henvmbbf6x.apifox.cn/283072900d0.md): - 默认目录 [StartRecordParam](https://henvmbbf6x.apifox.cn/283072901d0.md): - 默认目录 [StartStreamParam](https://henvmbbf6x.apifox.cn/283072902d0.md): - 默认目录 [StopStreamParam](https://henvmbbf6x.apifox.cn/283072904d0.md): - 默认目录 [StreamRecordResp](https://henvmbbf6x.apifox.cn/283072905d0.md): - 默认目录 [StreamStateParam](https://henvmbbf6x.apifox.cn/283072906d0.md): - 默认目录 [UpdateWebTokenItem](https://henvmbbf6x.apifox.cn/283072907d0.md): - 默认目录 [UpdateWebTokenParam](https://henvmbbf6x.apifox.cn/283072908d0.md): - 默认目录 [ParentFileInfos](https://henvmbbf6x.apifox.cn/283072909d0.md): - 默认目录 [TagItem](https://henvmbbf6x.apifox.cn/283072910d0.md): - 默认目录 [TagListOutput](https://henvmbbf6x.apifox.cn/283072911d0.md): - 默认目录 [WaylineInfo](https://henvmbbf6x.apifox.cn/283072912d0.md): - 默认目录 [ZipCheckOutput](https://henvmbbf6x.apifox.cn/283072913d0.md): - 默认目录 [Organization](https://henvmbbf6x.apifox.cn/283072914d0.md): - 默认目录 [DeviceControlStatus](https://henvmbbf6x.apifox.cn/283072916d0.md): - 默认目录 [DeviceControlCollection](https://henvmbbf6x.apifox.cn/283072917d0.md): - 默认目录 [DevicePrePreemptiveQueue](https://henvmbbf6x.apifox.cn/283072918d0.md): - 默认目录 [UserExperienceImprovement](https://henvmbbf6x.apifox.cn/283072920d0.md): - 默认目录 [ServiceError](https://henvmbbf6x.apifox.cn/283072921d0.md): - 默认目录 [ProjectWeatherBlocking](https://henvmbbf6x.apifox.cn/283072922d0.md): - 默认目录 [ChangeLensStreamParam](https://henvmbbf6x.apifox.cn/283072923d0.md): - 默认目录 [PagyInfo](https://henvmbbf6x.apifox.cn/283072925d0.md): - 默认目录 [DriveStatisticsOutput](https://henvmbbf6x.apifox.cn/283072927d0.md): - 默认目录 [StreamGroup](https://henvmbbf6x.apifox.cn/283072929d0.md): - 默认目录 [MediaFileListOutput](https://henvmbbf6x.apifox.cn/283072932d0.md): - 默认目录 [GetOrganizationsManageDevicesDeviceModelKeyResp](https://henvmbbf6x.apifox.cn/283072935d0.md): - 默认目录 [PostCommonCloudControlFunctionResp](https://henvmbbf6x.apifox.cn/283072936d0.md): - 默认目录 [GetOrganizationsDevicesRtkAccountInfoResp](https://henvmbbf6x.apifox.cn/283072937d0.md): - 默认目录 [GetOrganizationsByUuidManageDevicesCmdsResp](https://henvmbbf6x.apifox.cn/283072938d0.md): - 默认目录 [PostWorkspacesFlightTasksDroneTakeOffResp](https://henvmbbf6x.apifox.cn/283072940d0.md): - 默认目录 [PostWorkspacesFlightTasksFlyToPointsResp](https://henvmbbf6x.apifox.cn/283072941d0.md): - 默认目录 [GetWorkspacesFlightTasksDefaultNameResp](https://henvmbbf6x.apifox.cn/283072942d0.md): - 默认目录 [PostProjectsFlightTasksInFlightWayLineTaskResp](https://henvmbbf6x.apifox.cn/283072943d0.md): - 默认目录 [GetWorkspacesFlightTasksPoiTaskResp](https://henvmbbf6x.apifox.cn/283072945d0.md): - 默认目录 [PostWorkspacesFlightTasksPoiEnterResp](https://henvmbbf6x.apifox.cn/283072946d0.md): - 默认目录 [PostWorkspacesFlightTasksRelayMissionsPositionsResp](https://henvmbbf6x.apifox.cn/283072947d0.md): - 默认目录 [PostWorkspacesFlightTasksRelayMissionsActiveTakeoffResp](https://henvmbbf6x.apifox.cn/283072948d0.md): - 默认目录 [PostProjectsRtChannelsResp](https://henvmbbf6x.apifox.cn/283072949d0.md): - 默认目录 [PostProjectsVoiceChannelsResp](https://henvmbbf6x.apifox.cn/283072950d0.md): - 默认目录 [DeleteProjectsShareLiveResp](https://henvmbbf6x.apifox.cn/283072951d0.md): - 默认目录 [PostWorkspacesElementGroupsElementsResp](https://henvmbbf6x.apifox.cn/283072952d0.md): - 默认目录 [DeleteWorkspacesElementsResp](https://henvmbbf6x.apifox.cn/283072953d0.md): - 默认目录 [PutWorkspacesElementsResp](https://henvmbbf6x.apifox.cn/283072954d0.md): - 默认目录 [DeleteWorkspacesByWorkspaceIdElementGroupsResp](https://henvmbbf6x.apifox.cn/283072955d0.md): - 默认目录 [DeleteWorkspacesElementGroupsElementsResp](https://henvmbbf6x.apifox.cn/283072956d0.md): - 默认目录 [PostWorkspacesElementGroupsResp](https://henvmbbf6x.apifox.cn/283072957d0.md): - 默认目录 [DeleteWorkspacesByWorkspaceIdElementGroupsByGroupIdResp](https://henvmbbf6x.apifox.cn/283072958d0.md): - 默认目录 [PutWorkspacesElementGroupsResp](https://henvmbbf6x.apifox.cn/283072959d0.md): - 默认目录 [PostWorkspacesElementGroupsUndistributionResp](https://henvmbbf6x.apifox.cn/283072960d0.md): - 默认目录 [PutWorkspacesElementGroupsElementsStatusResp](https://henvmbbf6x.apifox.cn/283072961d0.md): - 默认目录 [PutWorkspacesElementGroupsLockStatusResp](https://henvmbbf6x.apifox.cn/283072962d0.md): - 默认目录 [PostWorkspacesElementGroupsDistributionResp](https://henvmbbf6x.apifox.cn/283072963d0.md): - 默认目录 [PutWorkspacesWorkspaceIdMediasShowOnMapResp](https://henvmbbf6x.apifox.cn/283072964d0.md): - 默认目录 [GetWorkspacesReconstructionsResp](https://henvmbbf6x.apifox.cn/283072965d0.md): - 默认目录 [GetWorkspacesFlightAreasResp](https://henvmbbf6x.apifox.cn/283072967d0.md): - 默认目录 [PostWorkspacesFlightAreasResp](https://henvmbbf6x.apifox.cn/283072968d0.md): - 默认目录 [DeleteWorkspacesFlightAreasResp](https://henvmbbf6x.apifox.cn/283072971d0.md): - 默认目录 [DeleteProjectFlightAreasResp](https://henvmbbf6x.apifox.cn/283072973d0.md): - 默认目录 [PostProjectFlightAreasResp](https://henvmbbf6x.apifox.cn/283072974d0.md): - 默认目录 [PostWorkspacesUploadCallbackResp](https://henvmbbf6x.apifox.cn/283072977d0.md): - 默认目录 [GetWorkspacesDefaultSettingsResp](https://henvmbbf6x.apifox.cn/283072978d0.md): - 默认目录 [PostModelStartRebuildResp](https://henvmbbf6x.apifox.cn/283072979d0.md): - 默认目录 [GetWorkspacesReconstructionsInterestAreaResp](https://henvmbbf6x.apifox.cn/283072980d0.md): - 默认目录 [GetWorkspacesReconstructionsReportResp](https://henvmbbf6x.apifox.cn/283072981d0.md): - 默认目录 [PostWorkspacesFilesResp](https://henvmbbf6x.apifox.cn/283072986d0.md): - 默认目录 [DeleteWorkspacesByWorkspaceIdFilesResp](https://henvmbbf6x.apifox.cn/283072987d0.md): - 默认目录 [DeleteWorkspacesByWorkspaceIdFilesByIdResp](https://henvmbbf6x.apifox.cn/283072988d0.md): - 默认目录 [GetWorkspacesWktsResp](https://henvmbbf6x.apifox.cn/283072991d0.md): - 默认目录 [PostWorkspacesFilesMoveResp](https://henvmbbf6x.apifox.cn/283072992d0.md): - 默认目录 [GetWorkspacesFilesTilesListResp](https://henvmbbf6x.apifox.cn/283072994d0.md): - 默认目录 [PostDiffMediaStartResp](https://henvmbbf6x.apifox.cn/283072995d0.md): - 默认目录 [GetDiffMediaTaskIdGetDetailResp](https://henvmbbf6x.apifox.cn/283072997d0.md): - 默认目录 [DeleteDiffMediaTaskIdResp](https://henvmbbf6x.apifox.cn/283072998d0.md): - 默认目录 [GetDiffMediaTaskIdGetReportResp](https://henvmbbf6x.apifox.cn/283072999d0.md): - 默认目录 [GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsResp](https://henvmbbf6x.apifox.cn/283073000d0.md): - 默认目录 [GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsByResultUuidResp](https://henvmbbf6x.apifox.cn/283073001d0.md): - 默认目录 [PostWorkspacesComparatorsResultGroupsDiffDetailResp](https://henvmbbf6x.apifox.cn/283073002d0.md): - 默认目录 [DeleteWorkspacesComparatorsResultGroupsDiffDetailResp](https://henvmbbf6x.apifox.cn/283073003d0.md): - 默认目录 [PostDiffModelStartResp](https://henvmbbf6x.apifox.cn/283073006d0.md): - 默认目录 [GetDiffModelTaskIdGetResultResp](https://henvmbbf6x.apifox.cn/283073007d0.md): - 默认目录 [PostWorkspacesComparatorsDiffDetailResp](https://henvmbbf6x.apifox.cn/283073008d0.md): - 默认目录 [DeleteWorkspacesComparatorsDiffDetailResp](https://henvmbbf6x.apifox.cn/283073009d0.md): - 默认目录 [GetDiffModelTaskIdGetReportResp](https://henvmbbf6x.apifox.cn/283073010d0.md): - 默认目录 [GetWorkspacesComparatorsMatchImageResp](https://henvmbbf6x.apifox.cn/283073011d0.md): - 默认目录 [GetWorkspacesGetKeyListResp](https://henvmbbf6x.apifox.cn/283073013d0.md): - 默认目录 [GetWorkspacesTilesJsonResp](https://henvmbbf6x.apifox.cn/283073014d0.md): - 默认目录 [PutModelBatchToggleDisplayResp](https://henvmbbf6x.apifox.cn/283073015d0.md): - 默认目录 [GetWorkspacesFileCountResp](https://henvmbbf6x.apifox.cn/283073016d0.md): - 默认目录 [DeleteDiffModelTaskIdResp](https://henvmbbf6x.apifox.cn/283073018d0.md): - 默认目录 [DeleteWorkspacesResourcesResp](https://henvmbbf6x.apifox.cn/283073023d0.md): - 默认目录 [PostOrganizationsAiInsideAlgorithmFileUploadResp](https://henvmbbf6x.apifox.cn/283073024d0.md): - 默认目录 [GetOrganizationsDevicesSimInfoResp](https://henvmbbf6x.apifox.cn/283073025d0.md): - 默认目录 [GetProjectsShareReportResp](https://henvmbbf6x.apifox.cn/283073026d0.md): - 默认目录 [DeleteProjectsShareReportResp](https://henvmbbf6x.apifox.cn/283073027d0.md): - 默认目录 [GetProjectsShareAnalyzerResp](https://henvmbbf6x.apifox.cn/283073028d0.md): - 默认目录 [GetProjectsShareModelResp](https://henvmbbf6x.apifox.cn/283073029d0.md): - 默认目录 [GetWorkspacesElementIconsResp](https://henvmbbf6x.apifox.cn/283073030d0.md): - 默认目录 [PostWorkspacesElementIconsResp](https://henvmbbf6x.apifox.cn/283073031d0.md): - 默认目录 [DeleteWorkspacesElementIconsResp](https://henvmbbf6x.apifox.cn/283073032d0.md): - 默认目录 [PostProjectSignalMapsResp](https://henvmbbf6x.apifox.cn/283073033d0.md): - 默认目录 [PostOrganizationsAiLinkAlgorithmsResp](https://henvmbbf6x.apifox.cn/283073034d0.md): - 默认目录 [DeleteOrganizationsAiLinkAlgorithmsResp](https://henvmbbf6x.apifox.cn/283073035d0.md): - 默认目录 [PutOrganizationsAiLinkAlgorithmsResp](https://henvmbbf6x.apifox.cn/283073036d0.md): - 默认目录 [GetOrganizationsAiLinkAlgorithmsResp](https://henvmbbf6x.apifox.cn/283073037d0.md): - 默认目录 [PostOrganizationsAiLinkAlgorithmsInstancesResp](https://henvmbbf6x.apifox.cn/283073038d0.md): - 默认目录 [DeleteOrganizationsAiLinkAlgorithmsInstancesResp](https://henvmbbf6x.apifox.cn/283073039d0.md): - 默认目录 [PutOrganizationsAiLinkAlgorithmsInstancesResp](https://henvmbbf6x.apifox.cn/283073040d0.md): - 默认目录 [GetOrganizationsAiLinkAlgorithmsInstancesResp](https://henvmbbf6x.apifox.cn/283073041d0.md): - 默认目录 [GetProjectsAiLinkAlgorithmsInstancesResp](https://henvmbbf6x.apifox.cn/283073042d0.md): - 默认目录 [ApiPagedEnvelope](https://henvmbbf6x.apifox.cn/283073043d0.md): - 默认目录 [GetOrganizationsDevicesEsimInfoResp](https://henvmbbf6x.apifox.cn/283073044d0.md): - 默认目录 [InitPermissionTreeNode](https://henvmbbf6x.apifox.cn/283073046d0.md): - 默认目录 [DroneControlsSnapshot](https://henvmbbf6x.apifox.cn/283073048d0.md): - 默认目录 [DeviceHmsInfoItem](https://henvmbbf6x.apifox.cn/283073049d0.md): - 默认目录 [PostWorkspacesWaylinesMoveResp](https://henvmbbf6x.apifox.cn/283073051d0.md): - 默认目录 [PutWorkspacesWaylineMoveResp](https://henvmbbf6x.apifox.cn/283073052d0.md): - 默认目录 [DeleteWorkspacesWaylinesByIdResp](https://henvmbbf6x.apifox.cn/283073053d0.md): - 默认目录 [PutWorkspacesWaylinesByIdResp](https://henvmbbf6x.apifox.cn/283073054d0.md): - 默认目录 [PostWorkspacesWaylinesByIdCopyResp](https://henvmbbf6x.apifox.cn/283073055d0.md): - 默认目录 [PostWorkspacesFavoritesResp](https://henvmbbf6x.apifox.cn/283073057d0.md): - 默认目录 [DeleteWorkspacesFavoritesResp](https://henvmbbf6x.apifox.cn/283073058d0.md): - 默认目录 [PostWorkspacesWaylinesConcatResp](https://henvmbbf6x.apifox.cn/283073059d0.md): - 默认目录 [PostWorkspacesOfflineMapsPackagesResp](https://henvmbbf6x.apifox.cn/283073061d0.md): - 默认目录 [PostWorkspacesOfflineMapsResp](https://henvmbbf6x.apifox.cn/283073063d0.md): - 默认目录 [DeleteWorkspacesOfflineMapsResp](https://henvmbbf6x.apifox.cn/283073064d0.md): - 默认目录 [PostCommonWeatherReportV2Resp](https://henvmbbf6x.apifox.cn/283073067d0.md): - 默认目录 [PostOrgManageDevicesCareEncryptSnResp](https://henvmbbf6x.apifox.cn/283073068d0.md): - 默认目录 [DeleteWorkspacesFlightTasksFlyToPointsResp](https://henvmbbf6x.apifox.cn/283073069d0.md): - 默认目录 [PostDrcCloudControlAuthResp](https://henvmbbf6x.apifox.cn/283073072d0.md): - 默认目录 [GetDrcCloudControlsResp](https://henvmbbf6x.apifox.cn/283073073d0.md): - 默认目录 [PostDrcCloudControlsResp](https://henvmbbf6x.apifox.cn/283073074d0.md): - 默认目录 [DeleteDrcCloudControlsResp](https://henvmbbf6x.apifox.cn/283073075d0.md): - 默认目录 [C0026_GetAutoRecordConfig_Resp](https://henvmbbf6x.apifox.cn/283073076d0.md): - 默认目录 [C0070_Op_get_Resp](https://henvmbbf6x.apifox.cn/283073084d0.md): - 默认目录 [C0073_Op_Resp](https://henvmbbf6x.apifox.cn/283073085d0.md): - 默认目录 [C0442_SIM_get_Resp](https://henvmbbf6x.apifox.cn/283073086d0.md): - 默认目录 [C0081_Op_get_Resp](https://henvmbbf6x.apifox.cn/283073087d0.md): - 默认目录 [C0086_Op_Resp](https://henvmbbf6x.apifox.cn/283073088d0.md): - 默认目录 [C0085_Op_Resp](https://henvmbbf6x.apifox.cn/283073089d0.md): - 默认目录 [C0467_GEOCaging_Resp](https://henvmbbf6x.apifox.cn/283073090d0.md): - 默认目录 [C0048_Op_get_Resp](https://henvmbbf6x.apifox.cn/283073094d0.md): - 默认目录 [C0050_Op_Resp](https://henvmbbf6x.apifox.cn/283073095d0.md): - 默认目录 [C0494_GetOnlineDeviceQuota_Resp](https://henvmbbf6x.apifox.cn/283073096d0.md): - 默认目录 [C0579_GetDefaultName_Resp](https://henvmbbf6x.apifox.cn/283073097d0.md): - 默认目录 [C0112_ProjectListcommandstatus_Resp](https://henvmbbf6x.apifox.cn/283073099d0.md): - 默认目录 [C0125_PoiGettask_Resp](https://henvmbbf6x.apifox.cn/283073100d0.md): - 默认目录 [C0145_GetRecordsSummary_Resp](https://henvmbbf6x.apifox.cn/283073101d0.md): - 默认目录 [C0147_ListExportTasks_Resp](https://henvmbbf6x.apifox.cn/283073102d0.md): - 默认目录 [C0148_ExportRecords_Resp](https://henvmbbf6x.apifox.cn/283073103d0.md): - 默认目录 [C0143_GetOperationLog_Resp](https://henvmbbf6x.apifox.cn/283073104d0.md): - 默认目录 [C0162_GetWaylineInfo_Resp](https://henvmbbf6x.apifox.cn/283073107d0.md): - 默认目录 [C0006_listFlightAlerts_Resp](https://henvmbbf6x.apifox.cn/283073108d0.md): - 默认目录 [C0559_GetAiAlertRecord_Resp](https://henvmbbf6x.apifox.cn/283073109d0.md): - 默认目录 [C0362_GetWaylineImportState_Resp](https://henvmbbf6x.apifox.cn/283073111d0.md): - 默认目录 [C0266_deleteWorkspacesWorkspaceIdElementGroupsGroupId_Resp](https://henvmbbf6x.apifox.cn/283073112d0.md): - 默认目录 [C0272_postWorkspacesWorkspaceIdElementGroupsGroupIdDistribution_Resp](https://henvmbbf6x.apifox.cn/283073113d0.md): - 默认目录 [C0333_get_tile_list_recon_files_Resp](https://henvmbbf6x.apifox.cn/283073114d0.md): - 默认目录 [C0401_get_model_get_key_list_Resp](https://henvmbbf6x.apifox.cn/283073115d0.md): - 默认目录 [C0402_get_model_get_tileset_any_Resp](https://henvmbbf6x.apifox.cn/283073116d0.md): - 默认目录 [C0396_getTrashConfig_Resp](https://henvmbbf6x.apifox.cn/283073117d0.md): - 默认目录 [C0241_get_projectsProjectUuidShareShareId_Resp](https://henvmbbf6x.apifox.cn/283073119d0.md): - 默认目录 [C0249_put_projectsProjectUuidShareShareId_Resp](https://henvmbbf6x.apifox.cn/283073120d0.md): - 默认目录 [C0247_put_projectUuidShareShareIdToggle_Resp](https://henvmbbf6x.apifox.cn/283073121d0.md): - 默认目录 [C0586_GetDeviceLinks_Resp](https://henvmbbf6x.apifox.cn/283073122d0.md): - 默认目录 [C0590_CreateTopologiesCmds_Resp](https://henvmbbf6x.apifox.cn/283073125d0.md): - 默认目录 [C0593_CreateRecordStop_Resp](https://henvmbbf6x.apifox.cn/283073126d0.md): - 默认目录 [C0594_GetControlStatus_Resp](https://henvmbbf6x.apifox.cn/283073127d0.md): - 默认目录 [C0600_GetOperationUsers_Resp](https://henvmbbf6x.apifox.cn/283073128d0.md): - 默认目录 [C0230_get_projectUuidDevicesDeviceSnRecords_Resp](https://henvmbbf6x.apifox.cn/283073130d0.md): - 默认目录 [C0222_post_stopRecord_Resp](https://henvmbbf6x.apifox.cn/283073131d0.md): - 默认目录 [C0226_post_startStream_Resp](https://henvmbbf6x.apifox.cn/283073132d0.md): - 默认目录 [C0612_CreateRecordStop_Resp](https://henvmbbf6x.apifox.cn/283073134d0.md):