DELETE /files/{id} 默认是软删进回收站,可通过额外参数永久删除;锁定的模型文件直接拒绝删除(PermissionDenied)。ids 精选」与「selected_parent_id + 筛选条件全选」两种模式,ids 非空时忽略 selected_parent_id。公共基础教程)。object_key_prefix 之下。模型上传完成回调(客户端调用,非 OSS 验签) (POST /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/upload-callback) 通知服务端登记入库。spec 顶层字段:object_key(必填)、name、id、file_type、sub_file_type、parent_id、show_on_map、fingerprint、metadata、ext。EXIF / 拍摄信息等业务上下文通常通过 metadata / ext 携带。当前 V2.0 私有化 spec 已移除 模型缩略图独立登记接口( POST /files/preview-callback);如部署方仍开放该端点,请按现场说明使用,不在本教程范围。
获取项目模型文件列表 (GET /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/files)。获取模型文件总数 (GET /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/file-count) — 复用列表筛选 DTO。获取模型文件详情 (GET /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/files/{id}) — 含建图元数据(覆盖面积 / GSD / 图源张数)、坐标系、显示属性。更新模型基本信息 (PUT /openapi/v2.0/model/api/v1/workspaces/{workspace_id}/files/{id}) — name 不允许含 /