核心用法
biver-builder 是面向 Biver 落地页构建平台的完整 API 集成技能，提供从页面创建到部署的全链路管理能力。
主要功能模块
| 模块 | 能力 |
|------|------|
| **页面管理** | 创建、更新、删除、部署落地页，支持草稿/已发布/已归档状态 |
| **子域系统** | 自动生成 `{name}.lp.biver.id` 子域，支持自定义路径 slug || **自定义域名** | 绑定独立域名，自动 SSL 证书，DNS 验证流程 |
| **区块编辑** | 10+ 种预设区块类型（hero、pricing、testimonials 等），支持原始 HTML/CSS |
| **AI 生成** | 基于提示词自动生成完整页面或单个区块，支持 8 大行业模板 |
| **产品目录** | 商品 SKU、库存、价格管理，支持对比价和分类 |
| **表单系统** | 表单创建与数据收集，提交端点无需认证（公开访问） |
| **资源库** | 图片/视频/文档上传，自动 CDN 分发 |
| **工作空间** | 品牌配置（logo、主色、字体）、SEO 全局设置、时区货币 |
认证与权限
采用 API Key 认证（bvr_live_ / bvr_test_ 双环境），细粒度 15 项作用域控制，涵盖读取/写入分离。
典型工作流
1. 快速上线：创建子域 → AI 生成页面 → 发布
2. 品牌部署：添加自定义域名 → DNS 验证 → 设为首选域名
3. 电商落地页：上传产品素材 → 创建产品目录 → 配置转化表单
显著优点
- 全栈覆盖：从域名到页面内容到数据收集一站式解决
- AI 原生：内置
/v1/ai端点，降低设计门槛 - 细粒度权限：15 项独立作用域，满足团队协作安全需求
- 无代码友好：区块级 HTML/CSS 控制兼顾灵活性与易用性
- 公开表单端点：
/v1/forms/:id/submit免认证设计，简化前端集成
潜在局限
- 生态封闭：仅服务 Biver 托管平台，无法导出静态站点
- 速率限制严格：免费档仅 30 请求/分钟，大型活动需提前升级
- AI 生成黑盒：未披露底层模型，输出质量不可控
- 无 Webhook 支持：实时事件需轮询 API
- 地域限制：文档暗示印尼市场为主（IDR 货币、Asia/Jakarta 时区）
适合人群
- 中小企业快速搭建营销落地页
- 无代码/低代码团队的技术负责人
- 需要子域批量管理的 SaaS 或代理机构
- 印尼及东南亚市场运营团队
常规风险
| 风险类型 | 说明 |
|----------|------|
| **供应商锁定** | 深度集成后迁移成本较高 |
| **速率突增** | 流量高峰易触发 429 限制，需监控 `X-RateLimit-*` 响应头 |
| **密钥泄露** | `pages:write` + `domains:write` 组合可篡改生产内容，需最小权限原则 |
| **AI 内容合规** | 自动生成内容需人工审核版权与地域合规性 |
| **表单垃圾数据** | 公开提交端点缺乏内置验证码，需配合前端防护 |