核心用法
Biver API 是一套面向开发者的 RESTful 接口，提供对 Biver 无代码着陆页构建平台的完整编程访问能力。开发者可通过 API 完成从页面创建、内容编辑、产品管理、表单收集到域名部署的全流程操作，无需登录图形界面即可实现自动化建站。
认证方式：采用 API Key 认证，支持 X-API-Key 或 Authorization: Bearer 两种请求头格式。密钥分 bvr_live_（生产环境）和 bvr_test_（沙盒环境）两种前缀，具备细粒度 Scope 权限控制，涵盖页面读写、产品管理、AI 生成等 15+ 个权限维度。
核心端点：
- Pages API：页面 CRUD、发布部署（deploy）
- Sections API：模块化区块管理，支持 Hero、Features、Pricing 等类型
- Products API：电商产品目录管理，含库存、SKU、价格字段
- Forms API：表单创建与提交，提交端点无需认证
- Gallery API：资源上传与 CDN 管理
- Domains/Subdomains API：自定义域名绑定与二级域名（
*.lp.biver.id）托管 - Workspace API：工作空间设置、品牌配置、SEO 全局管理
- AI Generation API：通过自然语言提示生成页面或区块内容
速率限制：按套餐分级，从免费版 SCOUT（30 req/min）到企业版 CHIEF（2000 req/min），响应头返回 X-RateLimit-* 系列字段供客户端自适应节流。
显著优点
1. 全功能覆盖：不仅支持内容管理，还集成域名 DNS 验证、SSL 状态查询、AI 内容生成，减少多工具链整合成本。
2. 开发者友好：请求/响应格式统一遵循 {success, data, error} 结构，错误码细化到业务场景（如 DUPLICATE_SUBDOMAIN、DEPLOY_FAILED），调试效率高。
3. 细粒度权限：Scope 机制允许为不同集成场景创建最小权限密钥，降低密钥泄露后的攻击面。
4. 沙盒隔离：bvr_test_ 前缀密钥确保测试操作零风险影响生产数据。
5. 无认证表单：公开表单提交通道（/v1/forms/:id/submit）便于前端直接接入，无需暴露密钥。
潜在缺点与局限性
- 印尼区域服务：主域名
biver.id及文档语言暗示服务主要面向印尼市场，全球 CDN 节点与合规认证（GDPR、SOC2 等）未在文档中明确披露，跨境业务需自行评估数据驻留风险。 - 速率上限偏低：即使最高档 CHIEF 计划也仅 2000 req/min，高并发场景（如大型活动页批量生成）可能需要客户端积极缓存或升级企业定制方案。
- AI 生成黑盒：
/v1/ai/*端点未披露底层模型版本、Token 消耗计费规则及内容审核机制，生产环境使用存在输出不可控与合规隐患。 - 无 Webhook 支持：文档未提及事件推送机制，状态变更（如域名验证完成、表单提交）需轮询查询，实时性受限。
- 无 GraphQL：仅提供 REST，复杂关联查询（如「获取所有页面及其关联产品」）需多次请求，效率受限。
适合人群
- 需要批量创建/管理着陆页的电商运营团队或营销机构
- 希望将建站能力集成进自有 SaaS 产品的开发者
- 追求无代码+低代码混合工作流的技术型创业公司
- 印尼本土企业及面向印尼市场的出海团队
常规风险
- 密钥泄露：API Key 一旦创建仅显示一次，丢失需重新生成；若生产密钥泄露，攻击者可篡改页面内容、删除资产或消耗 AI 生成额度。建议存储于密钥管理系统（如 AWS Secrets Manager、HashiCorp Vault），禁止硬编码。
- 子域名抢注：
DUPLICATE_SUBDOMAIN错误提示子域名全局唯一，热门词汇可能被抢占，建议提前预留关键品牌词。 - 自定义域名 DNS 配置错误：域名验证需正确配置 DNS TXT 记录，配置失误可能导致服务中断或域名被他人恶意验证（若验证逻辑存在缺陷）。
- 速率限制触发：突发流量易触发 429 错误，需实现指数退避重试策略。
- AI 内容合规：自动生成的文案与图片可能存在版权争议或不当内容，上线前需人工审核。