docs: site-import spec 终审两个文案 nit(API 数/retry 语义引 §3.3)
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
- 日期:2026-10-20
|
||||
- 状态:待评审
|
||||
- 范围:后端抓取/生成/任务三件套 + 3 个 API + admin 审核界面
|
||||
- 范围:后端抓取/生成/任务三件套 + 2 个 API + admin 审核界面
|
||||
- 前置:共享域名模式已上线(feature/shared-domain 合入 main);两次人工导入实操沉淀(租户 yotaienergys / televicsic,2026-10-20)
|
||||
|
||||
## 1. 背景与目标
|
||||
@@ -63,7 +63,7 @@
|
||||
|
||||
## 4. API(2 个端点,挂 platform 认证 + 既有 `_tenant_guard`,超管+租户管理员可用;路由文件 `app/platform/routes/site_import_routes.py` 照 config_routes 组织,挂 `/api/platform/tenants` 前缀)
|
||||
|
||||
- `POST /api/platform/tenants/{slug}/site-import` body `{url}`(或 `{retry: "generate"}` 复用进行中任务的抓取产物)→ `{task_id}`。校验:URL 格式 http(s);目标租户非停用;无同租户进行中任务(409)。
|
||||
- `POST /api/platform/tenants/{slug}/site-import` body `{url}`(或 `{retry: "generate"}`——语义见 §3.3:failed-at-generate 任务 30 分钟窗口内同 task_id 复活重跑生成步)→ `{task_id}`。校验:URL 格式 http(s);目标租户非停用;无同租户进行中任务(409)。
|
||||
- `GET /api/platform/tenants/{slug}/site-import/{task_id}` → `{status, phase?, pages?, draft?, warnings?, error?}`(done 时含完整草稿包)。
|
||||
|
||||
草稿包结构:
|
||||
|
||||
Reference in New Issue
Block a user