导出状态查询接口
开发中
GET
/api/project/export/status
导出状态 API 文档
1. 状态查询接口
GET /api/project/export/status检查当前系统是否正在执行导出任务，并返回剩余等待时间（如果正在导出）。
2. 返回数据结构
情况 1：系统空闲（可立即导出）
{
"isExporting": false
}| 字段 | 类型 | 说明 |
|---|---|---|
isExporting | boolean | false 表示当前无导出任务 |
情况 2：系统繁忙（导出中）
{
"isExporting": true,
"estimatedTime": 30000,
"remainingTime": 24044
}| 字段 | 类型 | 说明 |
|---|---|---|
isExporting | boolean | true 表示当前有导出任务正在进行 |
estimatedTime | number | 预估总耗时（毫秒），基于历史数据计算（示例值 30000 表示预计 30 秒完成） |
remainingTime | number | 剩余等待时间（毫秒），动态计算（示例值 24044 表示剩余约 24 秒） |
3. 使用场景示例
前端轮询逻辑
导出接口冲突响应
HTTP 423 Locked
{
"error": "系统繁忙，请稍后再试",
"retryAfter": 24044
}1.
2.
retryAfter / 1000 秒）3.
/export/status 直到 isExporting 为 false4. 注意事项
1.
所有时间字段均以 毫秒（ms） 为单位，前端需转换显示（如
remainingTime / 1000 显示为秒）。2.
remainingTime 是服务端实时计算的近似值，实际导出完成时间可能有 ±2 秒误差。3.
如果导出任务意外中断（如服务崩溃），
isExporting 会被自动重置为 false（通过 on-finished 兜底）。4.
estimatedTime 初始值为 30 秒，后续会根据历史任务耗时动态调整（如最近 3 次平均耗时 × 1.2）。5. 与其他接口的关系
| 接口 | 关联逻辑 |
|---|---|
POST /api/project/export | 调用前建议先检查 /export/status，避免直接触发 423 错误 |
GET /export/status | 在收到 423 错误后，应持续轮询此接口直到 isExporting 为 false |
6. 可视 化建议
isExporting: false）isExporting: true + 动态倒计时）请求参数
请求示例代码
返回响应
修改于 2025-07-02 00:25:44