1. 组织与项目
【私有化】司空 2 OpenAPI V2.0
  • 调用指南
    • 认证鉴权教程
    • 错误码
    • 请求结构
    • 返回结果
    • 公共参数
  • 公共基础
    • 公共基础教程
    • 系统健康与接入
      • DRC 服务健康检查
    • 接入与授权
      • STS 凭证
        • 获取业务模块定制 STS 凭证
        • 获取项目级文件直传 STS 凭证
        • 获取飞行记录上传 STS 凭证
    • 安全
      • 解密飞行记录中的设备序列号(SN)
  • 组织与项目
    • 组织与项目教程
    • 项目管理
      • 项目配置
        • 获取项目自动录制配置
        • 配置项目自动录制规则
      • 项目基础信息
        • 创建项目
        • 更新项目信息
        • 获取项目详情
        • 删除项目
      • 快速加入
        • 查询快速加入项目信息
        • 通过快速加入码加入项目
    • 组织管理
      • 查询组织项目列表
      • 更新当前用户订阅设置
      • 获取组织详情
      • 更新组织信息
    • 成员与权限管理
      • 角色与权限
        • 获取项目权限树定义
        • 查询组织内项目角色列表
        • 批量创建项目级自定义角色
        • 查询角色权限映射 (角色 ID → 权限列表)
        • 删除组织自定义角色
        • 更新自定义角色
      • 组织成员
        • 批量移除组织成员
        • 查询组织成员列表
        • 批量添加组织成员
        • 批量更新组织成员信息
        • 查询当前用户在该组织内的身份与配置
        • 更新当前用户的组织呼号
        • 当前用户退出组织
      • 项目成员
        • 获取项目团队成员(在线)
        • 获取项目用户列表
        • 更新当前用户的项目呼号
  • 设备管理
    • 设备管理教程
    • 设备配置
      • HMS 事件
        • 获取组织设备 HMS 事件列表
        • 更新组织设备 HMS 已读时间
        • 更新项目设备 HMS 已读时间
        • 批量获取项目设备 HMS 事件
      • 设备影子
        • 更新组织设备影子配置
        • 更新项目设备影子配置
        • 查询组织设备物模型属性当前值
      • 通用配置指令
        • 对组织设备下发自定义指令(通用 cmds 通道)
        • 查询组织设备指令执行进度
        • 批量查询组织设备指令执行进度
        • 对项目内设备下发指令
      • 网络管理
        • 查询设备当前 NTP 服务器配置
        • 启动设备网络速度检测任务
        • 查询设备网络测速任务结果
        • 查询机库网络配置
        • 检测机库网络连接
        • 查询 4G 模组 APN 配置
      • RTK 配置
        • 查询设备的 RTK 网络账号信息
        • 自定义网络 RTK 标定
      • 对频管理
        • 查询设备对频信息
        • 设备对频指令下发
        • 查询中继扫描结果
        • 查询中继非配对连接结果
        • 查询配对请求结果
      • SIM 卡管理
        • 查询设备 SIM 卡套餐与流量信息
      • 项目设备配置
        • 修改项目设备配置参数
        • 获取项目设备配置
    • 设备列表管理
      • 项目设备列表
        • 修改组织设备的当前工作项目
        • 获取项目设备列表
        • 获取项目内单个设备详情
        • 修改项目内设备项目呼号
        • 获取项目历史拓扑设备列表
        • 获取项目设备物模型
      • 组织设备列表
        • 查询组织设备简表
        • 批量修改组织设备呼号
        • 修改单个组织设备呼号
        • 批量移除组织设备
        • 查询组织设备运维列表
        • 查询组织内某类设备的机型主键列表
        • 查询组织设备在线工作配额
  • 实时控制
    • 实时控制教程
    • 飞行控制指令
      • 实时指令
        • 查询项目内设备命令执行进度
        • 下发飞行控制指令
      • 空中任务
        • 创建空中下发航线任务
        • 控制航线任务(暂停 / 继续 / 取消)
      • 指点飞行
        • 获取飞行任务的设备推荐结果
        • 飞向目标点(一键起飞)
        • 发起飞向多目标点任务
        • 更新进行中的飞向目标点任务
        • 结束飞向目标点任务
      • 智能环绕
        • 进入 POI 环绕模式
        • 退出 POI 环绕模式
        • 更新 POI 环绕速度
        • 查询 POI 任务状态
      • 接力任务
        • 创建接力任务(双机轮转)
        • 计算接力任务的最佳接力位置
        • 编辑接力任务配置
        • 触发接力机主动起飞
        • 更新接力任务运行状态(暂停 / 恢复 / 取消)
        • 主动切换接力任务的执行机
    • 控制权管理
      • 设备控制权
        • 设备控制权操作(组织设备运维)
        • 查询设备控制权状态(组织设备运维)
        • 获取(占用)云控角色
        • 查询项目设备控制权状态
        • 查询设备最近正在操作的项目内用户列表
        • 设备控制权操作
      • 云控权限
        • 申请云控授权(向遥控器发起)
        • 批量查询飞行器云控权状态
        • 获取(占用)云控权限
        • 释放云控权限
    • 负载控制
      • 相机控制
        • 下发负载控制指令
      • PSDK 设备
        • 下发 PSDK 指令
      • 喊话器
        • 打开飞行器双向语音通道
        • 打开 DRC 实时控制通道
        • 查询喊话器资源列表
        • 创建喊话器资源
        • 删除喊话器资源
        • 编辑喊话器资源
        • 获取喊话器音频上传 STS 凭证
    • 起降协调
      • 查询起降协调区(TCA)实时状态
  • 飞行任务
    • 飞行任务教程
    • 任务查询
      • 获取当前活动航线任务(DRC 实时控制)
      • 获取当前活动航线任务(任务管理)
      • 按 UUID 批量查询飞行任务详情
      • 查询飞行任务时间冲突列表
      • 获取飞行任务详细信息(V2,含执行明细)
      • 查询机场最近 / 当前任务
      • 获取任务飞行轨迹(V2)
    • 飞行记录
      • 导出与下载
        • 飞行记录文件下载
        • 查询飞行任务导出历史
        • 导出飞行任务记录(生成 zip 异步任务)
        • 取消 / 删除导出任务
      • 操作日志
        • 查询飞行任务操作日志(V2)
    • 任务管理
      • 创建飞行任务
      • 创建飞行任务(高级版,返回子任务)
      • 检查飞行任务是否满足下发条件
      • 标记任务为已读状态
      • 检查飞行任务阻飞项
      • 支持断点续飞的立即任务
      • 删除飞行任务
      • 编辑飞行任务
      • 获取飞行任务详情
      • 下发任务媒体优先上传指令
      • 创建续飞任务(保留原断点)
      • 更新飞行任务挂起状态(挂起 / 解除挂起 / 取消)
      • 查询飞行任务列表
    • AI 飞行告警
      • 按设备 SN 查询有 AI 告警的飞行架次列表
      • 查询历史 AI 告警记录
  • 航线
    • 航线教程
    • 下载与上传
      • 打包资源到 KMZ(精准复拍流程)
      • 查询航线异步导入状态
      • 保存航线时 KMZ 上传完成回调
      • 航线 KMZ 文件导入回调
      • 批量下载航线 / 文件夹(打包 zip)
    • 航线列表管理
      • 获取航线 KMZ 下载 URL 并 302 重定向
      • 复制航线
      • 收藏航线 / 媒体资源
      • 取消收藏航线 / 媒体资源
      • 多航线拼接为一条
      • 航线库文件列表查询(V1)
      • 删除指定航线(默认软删进回收站)
      • 更新航线元信息(改名 / 锁定 / 恢复回收站)
      • 获取单条航线详情
    • 航线文件 CRUD
      • 创建航线文件夹
      • 批量删除航线 / 文件夹
      • 批量移动航线 / 文件夹到目标文件夹
      • 批量更新航线 / 文件夹锁定状态
  • 地图
    • 地图教程
    • 地图标注
      • 标注图层管理
        • 移动 / 重排图层与要素
        • 删除单个标注图层(文件夹)
        • 更新标注图层(改名 / 重排)
        • 分发标注图层到设备端
        • 锁定 / 解锁标注图层
        • 取消分发标注图层
        • 批量删除标注图层 / 要素
        • 创建标注图层(文件夹)
        • 查询标注图层(文件夹)列表
      • 标注要素管理
        • 批量修改图层下要素的显示状态
        • 清空指定图层下的所有标注要素
        • 在指定图层下创建标注要素
        • 批量导入图层及标注(KML 风格 JSON)
        • 导出图层组下要素(KML 风格 JSON)
        • 删除单个标注要素
        • 更新标注要素(改名 / 改坐标 / 改样式 / 改顺序)
      • 自定义图标
        • 查询项目自定义点位图标库
        • 注册自定义点位图标
        • 删除自定义点位图标
    • 信号热力图
      • 查询组织级信号热力图
      • 查询项目级信号热力图
    • 空域安全
      • 自定义飞行区
        • 查询项目下的飞行区域列表
        • 创建飞行区域
        • 触发飞行区配置同步到设备
        • 删除飞行区域
        • 更新飞行区域
    • 离线地图
      • 获取离线地图地表模型下载 URL
      • 触发离线地图包同步到机库
      • 获取项目离线地图详情
      • 配置项目离线地图清单(启动新一次更新)
      • 取消离线地图模型更新
  • 直播
    • 直播教程
    • 直播分享与转发
      • 旁路推流
        • 创建 / 开启 / 关闭 / 更新码流转发器
        • 查询当前组织的旁路转码器列表
        • 停止并删除指定旁路转码器(C2C 直播旁路)
      • 直播分享
        • 获取设备直播分享详情
        • 查询项目下所有直播分享链接
    • 直播推流
      • 项目维度
        • 启动直播流(项目维度)
        • 更新观众 Token(项目维度
        • 切换镜头(项目维度)
        • 切换直播相机(项目维度)
        • 上报观众加入直播房间状态(项目维度)
        • 停止直播流(项目维度)
        • 设置直播质量(项目维度,飞行器源端推流档位)
        • 查询设备直播与录制状态(项目维度)
      • 组织维度
        • 停止直播流(组织维度)
        • 设置直播质量(组织维度,飞行器源端推流档位)
        • 上报观众加入直播房间状态(组织维度)
        • 启动直播流(组织维度)
        • 切换镜头(组织维度,同时控制飞行器源端硬件)
        • 更新观众 Token(组织维度)
        • 切换直播相机(组织维度)
    • 录制任务管理
      • 开始云端录制(项目维度)
      • 停止云端录制(项目维度)
      • 查询设备录制任务列表(项目维度)
      • 启动项目内直播流
      • 查询设备录制任务列表(组织维度)
      • 开始云端录制(组织维度)
      • 停止云端录制(组织维度)
      • 停止项目内直播录制
  • 媒体
    • 媒体教程
    • 飞行任务关联
      • 按 flight_id 查飞行任务媒体
      • 批量按 flight_ids 查飞行媒体
    • 文件统计与查询
      • 获取媒体文件计数(按文件夹粒度)
      • 获取媒体文件总数(项目全量)
      • 获取媒体资源文件(图 + 文件夹)
    • 媒体文件 CRUD
      • 批量设置媒体地图显示状态
      • 批量删除媒体文件 -进回收站
      • 创建媒体文件夹
      • 获取媒体文件列表
      • 媒体文件裁剪
      • 批量移动媒体文件
      • 删除单个媒体文件
      • 获取媒体文件详情
      • 更新媒体文件信息
      • 批量硬删媒体文件-不进回收站
    • 下载与上传
      • 快速上传媒体文件
      • 导入媒体文件
      • 检查新文件指纹存在状态
      • 涂鸦回调
      • 媒体上传完成回调
      • 检查 zip 打包任务状态
      • 打包媒体文件为 zip
      • 获取媒体文件下载 URL
    • 标签管理
      • 为媒体文件添加标签
      • 删除媒体文件标签
      • 获取项目下的媒体文件标签列表
  • 模型
    • 模型教程
    • 模型重建
      • 模型重建坐标系
      • 获取飞行任务文件夹列表 V2
      • 获取实时建图任务列表
      • 发起实时建图任务(Realtime2D)
      • 获取项目模型库默认设置
      • 发起后处理重建任务(Post 2D / 3D)
      • 获取后重建默认兴趣区域
      • 获取后重建质量报告下载链接
      • 后重建任务重试
      • 停止后重建任务
      • 模型上传完成回调(客户端调用,非 OSS 验签)
      • 查询可用于模型重建的航线列表
    • 模型库
      • 模型文件管理
        • 批量删除模型文件
        • 获取项目模型文件列表
        • 创建模型文件夹
        • 批量切换模型上图状态
        • 锁定 / 解锁模型文件
        • 批量移动模型文件
        • 组织内模型共享
        • 获取模型文件总数
        • 删除单个模型文件
        • 获取模型文件详情
        • 更新模型基本信息
        • 获取模型文件下载 URL
        • 发起模型格式 / 坐标系转换任务
        • 获取项目可用的坐标系(WKT)列表
      • 地图展示
        • 批量设置实时建图模型的地形加载状态
        • 调整实时建图模型展示顺序(拖拽排序)
        • 更新建图任务元属性(改名 / 显隐 / 分发 / 取消分发 / 切换地形)
        • 获取地图页模型图层列表
        • 批量切换地图模型图层属性
        • 调整地图模型图层叠加顺序
  • 开放建模
    • 开放建模教程
    • 错误码
    • 更新日志
    • 算法参数介绍
    • 获取正在重建中的模型详情
    • 获取资源详情
    • 删除资源
    • 获取上传凭证
    • 开始重建任务
    • 上传回调
    • 停止重建任务
    • 获取模型详情
    • 删除模型
  • 回收站
    • 回收站教程
    • 单条硬删媒体文件
    • 从回收站恢复文件
    • 永久删除回收站文件
    • 获取媒体回收站文件列表
    • 修改媒体回收站配置
    • 获取媒体回收站配置
    • 获取模型库回收站磁盘统计
    • 获取媒体回收站磁盘统计
  • 高级能力
    • 高级能力教程
    • 变化检测
      • 媒体变化检测
        • 发起媒体找不同任务
        • 查询媒体找不同任务列表
        • 删除找不同任务
        • 修改找不同任务名称等属性
        • 获取找不同任务详情
        • 评价找不同任务
        • 批量修改找不同结果状态
        • 删除变化区域
        • 添加变化区域(人工标注)
        • 更新变化区域属性
        • 获取媒体上传 STS 凭证
        • 媒体找不同任务预检
        • 查看找不同检测报告
        • 获取照片组 AI 找不同结果列表
        • 获取结果组中的变化区域详情
      • 模型变化检测
        • 发起模型对比任务(找不同)
        • 查询模型对比任务列表
        • 修改模型对比任务名称等属性
        • 获取模型对比任务结果详情
        • 删除模型对比任务
        • 批量更新模型对比差异
        • 删除模型对比差异
        • 添加模型对比差异(人工标注)
        • 更新模型对比单个差异详情
        • 获取模型对比检测报告
        • 查询适合做模型对比的候选模型
        • 评价模型对比任务
  • 数据模型
    • 默认目录
      • StsCredentials
      • ProjectShareLinkDetail
      • DrcStartStreamResp
      • PutWorkspacesWaylinesBatchDeleteResp
      • PutWorkspacesWaylinesLockStatusResp
      • GetWorkspacesOfflineMapsUrlResp
      • GetWorkspacesOfflineMapsResp
      • GetWorkspacesAirSenseWarningsResp
      • PostCommonWeatherReportResp
      • GetWorkspacesWebWaylinesResp
      • PostFlightTasksAdvancedReq
      • C0034_ListOrgUsers_Resp
      • C0038_GetProjectUserPermissionTree_Resp
      • C0030_ListProjectIndividuals_Resp
      • C0031_ListProjectUsers_Resp
      • C0095_Op_Resp
      • C0096_HMS_get_Resp
      • C0077_Op_get_Resp
      • C0058_Op_Resp
      • C0575_GetHistory_Resp
      • C0564_GetTopologies_Resp
      • C0580_GetInFlight_Resp
      • C0160_GetFlightTaskAdvanced_Resp
      • C0617_GetFlightTasks_Resp
      • StsResult
      • C0619_CreateBatchDownload_Resp
      • FlightOperationVO
      • FlightTask
      • C0253_get_convertersVolcList_Resp
      • User
      • C0587_CreateStreamsSwitch_Resp
      • C0589_GetTopologiesCmds_Resp
      • C0604_GetRecordDevice_Resp
      • C0607_GetRecordDevice_Resp
      • GetWorkspacesFilesCompareFilesResp
      • DeviceModelInfo
      • DeviceState_drone_other
      • DeviceState_ea210dock
      • Position
      • DeviceState_ea210drone
      • ProjectTeamGetDevicesRspItem
      • DeviceState_ea220dock
      • ProjectTeamGetDevicesRspItemBaseTopo
      • DeviceState_ea220drone
      • DeviceState_ea230dock
      • DeviceModelEnum
      • DeviceState_ea230drone
      • DeviceState_rc510
      • DeviceState_rc701
      • DeviceState_rc_other
      • DeviceState_wa345
      • DeviceState_wm265
      • StartStreamResp
      • Device
      • Project
      • ProjectTeamGetDevicesRsp
      • StatisticsInfo
      • ChunkedFile
      • Ancestor
      • MediaFileItem
      • GetOrganizationsDevicesResp
      • GetOrganizationsManageDevicesResp
      • PostWorkspacesFlightTasksDeviceRecommendationResp
      • GetWorkspacesFlightTasksInFlightResp
      • PutWorkspacesReconstructionsResp
      • PutWorkspacesFlightAreasResp
      • GetProjectFlightAreasUrlResp
      • PutProjectFlightAreasResp
      • GetProjectFlightAreasResp
      • PostModelReconstructPreCheckResp
      • GetWorkspacesReconWaylinesResp
      • GetModelListFlightFoldersResp
      • GetModelListFlightFoldersV2Resp
      • GetWorkspacesDriveStatisticsResp
      • GetWorkspacesFilesResp
      • GetWorkspacesFilesUrlResp
      • PostWorkspacesFilesPreviewCallbackResp
      • GetDiffMediaListResp
      • PostWorkspacesStsResp
      • GetDiffModelListResp
      • GetWorkspacesDriveStatisticsTrashResp
      • GetWorkspacesMapsModelsResp
      • GetWorkspacesStsResp
      • GetWorkspacesResourcesResp
      • PostWorkspacesResourcesResp
      • PutWorkspacesResourcesResp
      • Operation
      • Exception
      • FlightReplay
      • ListTaskWayline
      • FolderUploadInfo
      • Resp
      • TaskType
      • FlightTaskType
      • TaskStatus
      • MediaPosition
      • ApiEnvelope
      • UserContactInformation
      • LiveTokenResult
      • OrganizationIndustryType
      • OrganizationUnitsConfig
      • OrganizationGeoCagingConfig
      • OrganizationDeviceBindCode
      • ProjectWorkCenterPoint
      • CloudWeatherBlockingConfig
      • weatherBlocking
      • AirportWeatherStationBlockingConfig
      • ProjectShareConfig
      • ProjectFastJoin
      • DeviceControlOperationReq
      • DeviceControlOperationRsp
      • DeviceHmsInfo
      • DeviceShadowsDesired
      • ProjectTeamUpdateDeviceShadowReq
      • DeviceTopo
      • TopoGatewayDevice
      • TopoNodeDevice
      • TopoHostDevice
      • ActionType
      • TargetType
      • AiLinkHeartBeatRequest
      • AiLinkStartStreamRequest
      • ChangeCameraStreamParam
      • CommonStreamStruct
      • RecordTask
      • RecordTaskList
      • SetQualityParam
      • StartRecordParam
      • StartStreamParam
      • StopStreamParam
      • StreamRecordResp
      • StreamStateParam
      • UpdateWebTokenItem
      • UpdateWebTokenParam
      • ParentFileInfos
      • TagItem
      • TagListOutput
      • WaylineInfo
      • ZipCheckOutput
      • Organization
      • DeviceControlStatus
      • DeviceControlCollection
      • DevicePrePreemptiveQueue
      • UserExperienceImprovement
      • ServiceError
      • ProjectWeatherBlocking
      • ChangeLensStreamParam
      • PagyInfo
      • DriveStatisticsOutput
      • StreamGroup
      • MediaFileListOutput
      • GetOrganizationsManageDevicesDeviceModelKeyResp
      • PostCommonCloudControlFunctionResp
      • GetOrganizationsDevicesRtkAccountInfoResp
      • GetOrganizationsByUuidManageDevicesCmdsResp
      • PostWorkspacesFlightTasksDroneTakeOffResp
      • PostWorkspacesFlightTasksFlyToPointsResp
      • GetWorkspacesFlightTasksDefaultNameResp
      • PostProjectsFlightTasksInFlightWayLineTaskResp
      • GetWorkspacesFlightTasksPoiTaskResp
      • PostWorkspacesFlightTasksPoiEnterResp
      • PostWorkspacesFlightTasksRelayMissionsPositionsResp
      • PostWorkspacesFlightTasksRelayMissionsActiveTakeoffResp
      • PostProjectsRtChannelsResp
      • PostProjectsVoiceChannelsResp
      • DeleteProjectsShareLiveResp
      • PostWorkspacesElementGroupsElementsResp
      • DeleteWorkspacesElementsResp
      • PutWorkspacesElementsResp
      • DeleteWorkspacesByWorkspaceIdElementGroupsResp
      • DeleteWorkspacesElementGroupsElementsResp
      • PostWorkspacesElementGroupsResp
      • DeleteWorkspacesByWorkspaceIdElementGroupsByGroupIdResp
      • PutWorkspacesElementGroupsResp
      • PostWorkspacesElementGroupsUndistributionResp
      • PutWorkspacesElementGroupsElementsStatusResp
      • PutWorkspacesElementGroupsLockStatusResp
      • PostWorkspacesElementGroupsDistributionResp
      • PutWorkspacesWorkspaceIdMediasShowOnMapResp
      • GetWorkspacesReconstructionsResp
      • GetWorkspacesFlightAreasResp
      • PostWorkspacesFlightAreasResp
      • DeleteWorkspacesFlightAreasResp
      • DeleteProjectFlightAreasResp
      • PostProjectFlightAreasResp
      • PostWorkspacesUploadCallbackResp
      • GetWorkspacesDefaultSettingsResp
      • PostModelStartRebuildResp
      • GetWorkspacesReconstructionsInterestAreaResp
      • GetWorkspacesReconstructionsReportResp
      • PostWorkspacesFilesResp
      • DeleteWorkspacesByWorkspaceIdFilesResp
      • DeleteWorkspacesByWorkspaceIdFilesByIdResp
      • GetWorkspacesWktsResp
      • PostWorkspacesFilesMoveResp
      • GetWorkspacesFilesTilesListResp
      • PostDiffMediaStartResp
      • GetDiffMediaTaskIdGetDetailResp
      • DeleteDiffMediaTaskIdResp
      • GetDiffMediaTaskIdGetReportResp
      • GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsResp
      • GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsByResultUuidResp
      • PostWorkspacesComparatorsResultGroupsDiffDetailResp
      • DeleteWorkspacesComparatorsResultGroupsDiffDetailResp
      • PostDiffModelStartResp
      • GetDiffModelTaskIdGetResultResp
      • PostWorkspacesComparatorsDiffDetailResp
      • DeleteWorkspacesComparatorsDiffDetailResp
      • GetDiffModelTaskIdGetReportResp
      • GetWorkspacesComparatorsMatchImageResp
      • GetWorkspacesGetKeyListResp
      • GetWorkspacesTilesJsonResp
      • PutModelBatchToggleDisplayResp
      • GetWorkspacesFileCountResp
      • DeleteDiffModelTaskIdResp
      • DeleteWorkspacesResourcesResp
      • PostOrganizationsAiInsideAlgorithmFileUploadResp
      • GetOrganizationsDevicesSimInfoResp
      • GetProjectsShareReportResp
      • DeleteProjectsShareReportResp
      • GetProjectsShareAnalyzerResp
      • GetProjectsShareModelResp
      • GetWorkspacesElementIconsResp
      • PostWorkspacesElementIconsResp
      • DeleteWorkspacesElementIconsResp
      • PostProjectSignalMapsResp
      • PostOrganizationsAiLinkAlgorithmsResp
      • DeleteOrganizationsAiLinkAlgorithmsResp
      • PutOrganizationsAiLinkAlgorithmsResp
      • GetOrganizationsAiLinkAlgorithmsResp
      • PostOrganizationsAiLinkAlgorithmsInstancesResp
      • DeleteOrganizationsAiLinkAlgorithmsInstancesResp
      • PutOrganizationsAiLinkAlgorithmsInstancesResp
      • GetOrganizationsAiLinkAlgorithmsInstancesResp
      • GetProjectsAiLinkAlgorithmsInstancesResp
      • ApiPagedEnvelope
      • GetOrganizationsDevicesEsimInfoResp
      • InitPermissionTreeNode
      • DroneControlsSnapshot
      • DeviceHmsInfoItem
      • PostWorkspacesWaylinesMoveResp
      • PutWorkspacesWaylineMoveResp
      • DeleteWorkspacesWaylinesByIdResp
      • PutWorkspacesWaylinesByIdResp
      • PostWorkspacesWaylinesByIdCopyResp
      • PostWorkspacesFavoritesResp
      • DeleteWorkspacesFavoritesResp
      • PostWorkspacesWaylinesConcatResp
      • PostWorkspacesOfflineMapsPackagesResp
      • PostWorkspacesOfflineMapsResp
      • DeleteWorkspacesOfflineMapsResp
      • PostCommonWeatherReportV2Resp
      • PostOrgManageDevicesCareEncryptSnResp
      • DeleteWorkspacesFlightTasksFlyToPointsResp
      • PostDrcCloudControlAuthResp
      • GetDrcCloudControlsResp
      • PostDrcCloudControlsResp
      • DeleteDrcCloudControlsResp
      • C0026_GetAutoRecordConfig_Resp
      • C0070_Op_get_Resp
      • C0073_Op_Resp
      • C0442_SIM_get_Resp
      • C0081_Op_get_Resp
      • C0086_Op_Resp
      • C0085_Op_Resp
      • C0467_GEOCaging_Resp
      • C0048_Op_get_Resp
      • C0050_Op_Resp
      • C0494_GetOnlineDeviceQuota_Resp
      • C0579_GetDefaultName_Resp
      • C0112_ProjectListcommandstatus_Resp
      • C0125_PoiGettask_Resp
      • C0145_GetRecordsSummary_Resp
      • C0147_ListExportTasks_Resp
      • C0148_ExportRecords_Resp
      • C0143_GetOperationLog_Resp
      • C0162_GetWaylineInfo_Resp
      • C0006_listFlightAlerts_Resp
      • C0559_GetAiAlertRecord_Resp
      • C0362_GetWaylineImportState_Resp
      • C0266_deleteWorkspacesWorkspaceIdElementGroupsGroupId_Resp
      • C0272_postWorkspacesWorkspaceIdElementGroupsGroupIdDistribution_Resp
      • C0333_get_tile_list_recon_files_Resp
      • C0401_get_model_get_key_list_Resp
      • C0402_get_model_get_tileset_any_Resp
      • C0396_getTrashConfig_Resp
      • C0241_get_projectsProjectUuidShareShareId_Resp
      • C0249_put_projectsProjectUuidShareShareId_Resp
      • C0247_put_projectUuidShareShareIdToggle_Resp
      • C0586_GetDeviceLinks_Resp
      • C0590_CreateTopologiesCmds_Resp
      • C0593_CreateRecordStop_Resp
      • C0594_GetControlStatus_Resp
      • C0600_GetOperationUsers_Resp
      • C0230_get_projectUuidDevicesDeviceSnRecords_Resp
      • C0222_post_stopRecord_Resp
      • C0226_post_startStream_Resp
      • C0612_CreateRecordStop_Resp
    • 默认目录
  1. 组织与项目

组织与项目教程

功能介绍#

组织与项目模块覆盖司空 2 私有化版的 组织 / 项目 / 成员 / 角色 四个基础维度,是后续所有业务模块的入口。包含:
组织管理:组织详情查询与更新、组织维度的项目列表查询、当前用户的订阅设置。
项目管理:项目的 CRUD(创建 / 查询 / 更新 / 删除),以及项目级配置(自动录制规则)。
快速加入:通过快速加入码邀请用户加入项目(无需组织管理员手动添加)。
成员与权限管理:组织成员、项目成员、项目角色与权限树的管理。
私有化版本下,组织无法通过 OpenAPI 创建,必须先在司空 2 控制台创建组织、配置 OpenAPI 组织密钥后才能进入下面的流程。
项目可以通过 OpenAPI 创建,无需登录司空 2 控制台。
「项目用户列表」接口为假分页(page 固定 1,total = 列表长度);如需做客户端分页请基于完整结果集自行裁剪。

接口使用流程#

加载组织 / 项目基础信息#

调用步骤:
1.
通过 获取组织详情 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}) 加载当前组织的元信息。如需修改组织名称 / Logo / 行业 / 介绍 / 单位制 / 围栏配置等,使用 更新组织信息 (PUT /openapi/v2.0/manage/api/v1/organizations/{uuid})。
2.
通过 查询组织项目列表 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/projects) 拿到组织下所有项目的 uuid。当 usage=simple 时返回精简列表(不分页),否则按 page/page_size 分页返回。
3.
对感兴趣的项目调用 获取项目详情 (GET /openapi/v2.0/manage/api/v1/projects/{uuid}) 加载详情;返回字段中 is_project_updatable 标记当前用户是否可编辑该项目,project_fast_join.code 仅在拥有项目编辑权限时返回。

创建 / 更新 / 删除项目#

调用步骤:
1.
调用 创建项目 (POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/projects),body 中可同时初始化项目用户、项目设备、项目快速加入、项目坐标系、机库轮换、天气阻飞、媒体分享等配置(一次接口完成项目初始化)。
2.
后续修改项目元信息使用 更新项目信息 (PUT /openapi/v2.0/manage/api/v1/projects/{uuid})。
3.
删除项目 (DELETE /openapi/v2.0/manage/api/v1/projects/{uuid}) 会连带清理项目内成员、项目设备拓扑(设置工作项目字段为空)、项目通知与订阅;响应 data 字段返回被删除项目的最后一份快照(GetProjectRsp)。

快速加入项目#

适合三方系统通过扫码 / 邀请链接将外部用户拉入项目:
调用步骤:
1.
调用 查询快速加入项目信息 (GET /openapi/v2.0/manage/api/v1/projects/fast-join),必填 query:project_id(项目 UUID)、project_fast_join_code(快速加入码);可选 query:association_drone_device_sn(拟关联的飞行器 SN)。返回项目名、组织名、推荐项目呼号;若传入飞行器 SN,还会返回飞行器在该项目的推荐呼号。
2.
调用 通过快速加入码加入项目 (POST /openapi/v2.0/manage/api/v1/projects/fast-join) 提交加入。请求体形态:
project_fast_join(必填):{ project_id, project_fast_join_code, user_project_callsign? },其中 user_project_callsign 不传时由服务端自动使用账号名或组织昵称。
association_drone(可选):{ drone_device_sn, drone_project_callsign?, drone_model_key? },加入项目时同时关联一台飞行器。
如果当前用户不在该项目所属组织中,服务端会自动以临时成员身份加入组织。

成员与权限管理#

私有化版本提供组织成员、项目成员、项目角色三个层面的管理能力:
调用步骤:
1.
当前用户上下文:先调用 查询当前用户在该组织内的身份与配置 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/users/current) 拉取 Token 对应用户的组织级角色、订阅、单位、MFA、灰度等配置,作为后续操作的权限上下文。
2.
组织成员维护:
列表:查询组织成员列表 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/users),支持按 user_role(枚举:organization-super-admin / organization-admin / organization-device-manager / organization-member / organization-temporary-member / organization-visitor)/ source_type 过滤;若指定 project_uuid(query 参数),则要求调用者在该项目内可编辑。
添加:批量添加组织成员 (POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/users),账号需在用户中心已注册。
更新:批量更新组织成员信息 (PUT /openapi/v2.0/manage/api/v1/organizations/{uuid}/users),可修改角色 / 启用状态。
移除:批量移除组织成员 (DELETE /openapi/v2.0/manage/api/v1/organizations/{uuid}/users),按 user_id / account 匹配,会同时清理用户在该组织所有项目内的成员身份和订阅;失败项以错误码 + 失败用户列表返回。
3.
项目成员视图:
在线成员:获取项目团队成员(在线) (GET /openapi/v2.0/manage/api/v1/projects/{uuid}/members),按 web / app / RC 平台分类组装当前在线用户。
全量用户:获取项目用户列表 (GET /openapi/v2.0/manage/api/v1/projects/{uuid}/users),支持按 prj_user_role 过滤、按 nickname 排序;非项目成员调用时会回退到组织管理权限校验。
4.
当前用户自我维护:
修改组织呼号:更新当前用户的组织呼号 (PUT /openapi/v2.0/manage/api/v1/organizations/{uuid}/users/current)。注:当传入呼号与组织内已有用户重复时,服务端会自动追加后缀以保证唯一(不会以错误码拒绝),实际生效的呼号以响应为准。
修改项目呼号:更新当前用户的项目呼号 (PUT /openapi/v2.0/manage/api/v1/projects/{uuid}/users/current),返回完整项目角色信息。
退出组织:当前用户退出组织 (PUT /openapi/v2.0/manage/api/v1/organizations/{uuid}/users/current/operation)。
订阅设置:更新当前用户订阅设置 (POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/users/current/subscription) 控制订阅开关、订阅项目范围、是否自动订阅新加入项目、接收通道。

项目角色与权限管理#

调用步骤:
1.
加载权限元数据:获取项目权限树定义 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/permissions) 返回当前组织的初始化项目权限树(type 仅支持 project)。
2.
加载现有角色:查询组织内项目角色列表 (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/roles) 分页查询,包含预设角色和自定义角色。
3.
维护自定义角色:
创建:批量创建项目级自定义角色 (POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/roles)。
更新:更新自定义角色 (PUT /openapi/v2.0/manage/api/v1/organizations/{uuid}/roles/{role_id}),预设角色权限不可修改。
删除:删除组织自定义角色 (DELETE /openapi/v2.0/manage/api/v1/organizations/{uuid}/roles/{role_id}),删除前会校验角色归属于本组织且尚未被任何用户使用。
4.
角色 → 权限映射查询:查询角色权限映射 (角色 ID → 权限列表) (GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/roles/permissions),role_id 不传时返回当前组织所有项目角色,同时返回完整权限树。

项目自动录制配置#

每个项目可独立配置「自动录制」规则,按设备 SN + 相机维度决定哪些设备 / 哪个相机参与自动录制,并控制各端(机场 / 飞机 / 基站)的录制开关与文件自动清理时长:
调用步骤:
1.
项目设置页加载初始值:获取项目自动录制配置 (GET /openapi/v2.0/drc/api/v2/projects/{project_id}/auto_record/configs)。
2.
用户调整后回写:配置项目自动录制规则 (POST /openapi/v2.0/drc/api/v2/projects/{project_id}/auto_record/configs),请求体字段:
recording_items(必填,array):录制规则列表。每项 { sn, camera_index | camera_sn }:sn 为飞行器 SN;camera_index 是相机索引(与设备物模型 camera 一致,格式形如 52-0-0);camera_sn 是相机 SN,两者二选一(后端 IsValid() 校验)。
auto_cleaning_time(实质必填,integer):录制文件自动清理时长,单位天,取值范围 7–90,缺省或越界都会被后端 binding 校验拒绝。
disable_dock_recording / disable_drone_recording / disable_base_station_recording(boolean):分别禁用机场端 / 飞机端 / 基站端录制。

典型场景:创建项目并将用户、设备纳管#

与 V0.9 私有版「创建项目/添加设备 API 调用指南」保持一致的场景,适配到 V2.0 路径。
完整设备纳管 / 远程调试 / 任务下发的后续步骤参见「设备管理」与「实时控制」模块的教程。
修改于 2026-06-11 09:03:09
上一页
解密飞行记录中的设备序列号(SN)
下一页
获取项目自动录制配置
Built with