项目 API
项目管理相关的 API 接口。
获取项目列表
GET /api/projects
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| page | number | 页码,默认 1 |
| pageSize | number | 每页数量,默认 20 |
| keyword | string | 搜索关键词 |
响应示例
json
{
"success": true,
"data": {
"list": [
{
"id": "uuid",
"name": "示例项目",
"description": "项目描述",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-01T00:00:00Z"
}
],
"total": 100
}
}
创建项目
POST /api/projects
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 项目名称 |
| description | string | 否 | 项目描述 |
| isPublic | boolean | 否 | 是否公开 |
获取项目详情
GET /api/projects/{id}
响应示例
json
{
"success": true,
"data": {
"id": "uuid",
"name": "示例项目",
"description": "项目描述",
"files": [],
"layers": [],
"createdAt": "2026-01-01T00:00:00Z"
}
}
更新项目
PUT /api/projects/{id}
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 项目名称 |
| description | string | 否 | 项目描述 |
删除项目
DELETE /api/projects/{id}
分享项目
POST /api/projects/{id}/share
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| permission | string | 是 | 权限:read/write/admin |
| expiresIn | number | 否 | 过期时间(天) |