用途:帮助在调用 Juicebox AI 数据分析 API 时实现速率限制控制,避免触发 429 限流。
主要能力:提供各端点限额参考(数据集上传 20 次/分钟、分析触发 30 次/分钟、结果获取 120 次/分钟、数据增强 15 次/分钟、导出下载 10 次/分钟,均按 API 密钥计);给出令牌桶限流器 JuiceboxRateLimiter 实现、带 Retry-After 与抖动的重试策略 juiceboxRetry、以及分批分析函数 batchAnalyzeDatasets。
使用方式:按端点创建限流器实例(如 analysisLimiter、enrichLimiter),调用 acquire() 获取令牌后再发起请求;遇 429 读取 Retry-After 退避重试,5xx 用指数退避;批量分析按 batchSize 分批并间隔等待。
适用场景:跨多数据集比较分析、批量处理问卷结果、数据增强调用等重负载任务,建议将增强与分析安排在非高峰时段。
限制与注意:增强端点限额最低,需单独分批并加大间隔;上传超 50MB 需压缩或分块;导出需套餐支持,否则返回 403;复杂查询需轮询状态。资料还要求仅在合成数据与受控预算下测试,使用幂等键、仅聚合遥测,异常时暂停并回滚,测试后删除沙箱产物。具体套餐与价格暂未提供。