用途:为 Webflow 集成设计请求预算、队列与重试方案,适用于处理 429、批量同步吞吐、轮询以及 Content Delivery 缓存命中问题。
主要能力:以官方文档和项目实际安装版本为准,先做只读发现,再分离准备与线上变更;识别站点套餐、API 密钥、worker 数量、端点、请求量及操作类型(读取、幂等写入、发布);在密钥安全的客户端日志中测量实际响应头,区分单密钥容量与应用整体并发;设置低于文档预算的共享队列并为交互或恢复预留容量;遵循 Retry-After,否则使用带抖动的指数退避与有界尝试/截止策略;用文档化 webhook 替代轮询,Content Delivery 仅用于受支持的已发布条目读取;在夹具或开发站点做负载测试并报告可持续吞吐与失败行为。
当前契约:Data API 通用预算为 Starter 与 Basic 每分钟 60 次请求,CMS、Ecommerce、Business 为 120 次,Enterprise 自定义;限制按 API 密钥计;X-RateLimit-Limit、X-RateLimit-Remaining、Retry-After 暴露当前预算;Site Publish 每分钟仅允许一次成功发布;缓存 Content Delivery 响应可有效避开套餐限制,但 MISS 或 BYPASS 会回源并计入。
认证:Data API 使用 bearer token,可选站点令牌、工作区令牌或 OAuth,作用域按端点推导;不得读取、回显、持久化令牌值或将其放入命令、补丁、示例、日志与报告。
使用方式:先确认目标仓库或项目路径与检查权限,再按上述工作流执行;默认只读检查,任何创建、更新、删除、发布、取消发布、归档、部署、撤销令牌或注册 webhook 前,需展示环境与资源 ID、拟议变更、验证方法及回滚措施,仅在用户明确授权后执行,生产发布或破坏性操作需重新明确批准。
限制与错误处理:本地限流器仍出现 429 时,查找共享同一密钥的其他 worker 并协调共享预算;CDN MISS/BYPASS 按回源流量计入预算;发布被限流时串行化发布并确认前次完成后再重试。输出需区分文档事实、仓库证据与推断,并报告已检查项目与版本、已验证身份、端点与作用域契约、变更、验证证据、线上变更状态、回滚就绪度与剩余风险。