文件管理 API
文件上传和管理相关的 API 接口。
上传文件
POST /api/files/upload
请求格式
Content-Type: multipart/form-data
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | File | 是 | 文件 |
| projectId | string | 是 | 项目ID |
| description | string | 否 | 文件描述 |
支持的文件格式
- 影像:
.tif,.tiff,.cog - 地形:
.dem,.tif - 矢量:
.shp,.geojson,.kml - 3D模型:
.3dtiles,.i3s,.slpk
响应示例
json
{
"success": true,
"data": {
"id": "uuid",
"name": "data.tif",
"size": 1024000,
"type": "raster",
"status": "processing",
"projectId": "uuid"
}
}
获取文件列表
GET /api/files
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| projectId | string | 项目ID |
| type | string | 文件类型筛选 |
获取文件详情
GET /api/files/{id}
删除文件
DELETE /api/files/{id}
下载文件
GET /api/files/{id}/download
获取文件预览
GET /api/files/{id}/preview
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| width | number | 预览图宽度 |
| height | number | 预览图高度 |