Queenshow 产品详情页

解决的问题

手动维护商品详情页时，经常要处理素材上传、标题描述、分区结构、图片占位和生成状态。Queenshow Detail Page 把这条链路接到 Queenshow OpenAPI 上：先创建 editor-next 空文档，再通过异步任务生成商品大纲和分区图片，最后拉取并回写文档。适合需要脚本化生成或批量验证产品页的场景。

工作方式

核心流程围绕 /openapi/* 接口：

• 素材准备：用 POST /openapi/materials/upload 上传本地图片/视频，或复用已有公开素材 URL。
• 创建页面：调用 POST /openapi/detail-pages，product.mainImages 必填且最多 3 个 URL，同时提交 product_outline_generate 任务。
• 轮询状态：用 GET /openapi/detail-pages/{id}/status 等待 outline_ready。
• 应用大纲：调用 POST /openapi/detail-pages/{id}/outline/apply，生成分区图片占位并提交 section_image_generate 任务。
• 验收结果：完成后检查每个分区都有一个 image node，且 value.url、value.generationStatus 符合预期。
• 回写内容：用 POST /openapi/detail-pages/{id}/update 更新标题、描述、缩略图、商品或完整文档。

注意点

• 每个商品应使用独立 mainImage URL，避免素材串用导致内容泄漏。
• outline_ready 通常 20–40 秒，建议 8–10 秒轮询；5 张图片通常 2–4 分钟，建议 15 秒轮询。
• OpenAPI 未提供 publish/save 发布接口，update 只用于持久化内容。
• 批量任务前检查 GET /openapi/usage，余额不足可能导致页面被删除。
• 中文文本或 Windows 环境建议优先使用 scripts/detail_page_client.py，减少 UTF-8 与敏感字段处理成本。