REST API 端点清单

全部端点位于 /api/v1/tenant 前缀下，需 JWT 登录态。以下为分组速览（:siteID 为站点 ID）：

站点管理

• GET/POST /sites · GET/PUT/DELETE /sites/:siteID — 站点 CRUD（PUT 支持只传部分字段，含自动发布开关 auto_publish）
• POST /sites/:siteID/clone — 一键克隆（可选携带内容）
• PUT /sites/:siteID/apply-template · POST /sites/:siteID/domains — 套用模板 / 绑定自定义域名

栏目与内容

• GET/POST /sites/:siteID/categories · PUT/DELETE .../categories/:id — 栏目 CRUD + 排序
• GET/POST /sites/:siteID/contents · GET/PUT/DELETE .../contents/:id — 内容 CRUD（PUT 为整体覆盖语义，详见下方说明）
• GET /sites/:siteID/contents?has_draft=1 — 只取「有修改未上线」的内容；列表行的 draft_updated_at 非空即表示线上版本落后于编辑内容
• GET /sites/:siteID/publish-preflight — 发布前检查：返回 pending_drafts（待发布修改数）、auto_publish（站点自动发布开关 1/0）与配额、待发布内容等信息
• POST /sites/:siteID/contents-batch — 批量创建（含 AI 批量 SEO / 批量推送变体）
• GET .../contents/:id/versions · POST .../contents/:id/restore/:versionID — 版本历史与恢复（按发布记录，保存不产生版本）
• POST /sites/:siteID/import（CSV/JSON）· POST /sites/:siteID/wp-import/upload（WordPress WXR）— 两种导入通道，均支持任务进度与批次回滚
• GET /sites/:siteID/tags · POST /sites/:siteID/tags/merge — 标签管理与合并

媒体库

• GET/POST /sites/:siteID/media · PUT/DELETE .../media/:id — 上传 / 编辑 / 删除
• POST .../media/batch-ai-alt — AI 批量生成图片 alt 文本

页面与发布（编辑器域 /api/v1/editor）

• GET/POST /editor/sites/:siteID/pages · PUT/DELETE .../pages/:id — 页面管理
• GET/PUT /editor/sites/:siteID/pages/:id/schema — 页面可视化 Schema 读写
• POST /editor/sites/:siteID/publish — 触发全站静态化发布，GET /editor/publish-tasks/:taskID 轮询进度

AI 能力

• POST /tenant/ai/generate · /ai/generate-stream — 文章生成（含 SSE 流式）
• POST /tenant/ai/translate · /ai/rewrite · /ai/extract-tags — 翻译 / 改写 / 提标签
• POST /tenant/ai/build-site — 一句话 AI 建站

运营与集成

• GET/POST /sites/:siteID/forms + GET .../forms/:id/submissions — 表单与提交数据
• GET /sites/:siteID/comments + PUT .../comments/:id — 评论审核
• GET/POST /sites/:siteID/webhooks — Webhook 订阅管理（见 Webhook 文档）
• GET /tenant/traffic-overview · /tenant/hot-contents — 访客流量与热文榜