SuperAPI AI 工具集

documenso-rate-limits

办公与效率

查看项目

更新于 10-15 23:25

技能介绍

用途:针对 Documenso 文档与签署集成,在调用 API 时实现限流、退避与请求节流,减少 429 报错、重复邀请、重复签名或意外修改文档。

主要能力:提供指数退避加抖动的重试封装(maxRetries 默认 5、baseDelayMs 1000、maxDelayMs 60000);仅对 429 与 5xx 重试,4xx(非 429)直接抛出;用 p-queue 做并发控制(示例 concurrency 5、interval 1000、intervalCap 10)批量创建文档;提供熔断器,失败达阈值(默认 5 次)后打开,30 秒后进入半开;给出等价的 Python 重试示例。

Documenso 的限额模型:官方采用公平使用模式,未公布每分钟请求配额。免费版有文档数量限制;Individual、Team、Enterprise 计划标注为文档、API 与签署量无限;自托管无限制。官方不针对 API 用量收费,实际约束主要针对滥用流量(如每秒数千请求)。若收到 429,应使用指数退避与请求排队。

使用方式:需先安装 Documenso SDK,熟悉 async/await,并完成 documenso-install-auth 配置。示例命令与代码保持原样:withRetry 封装调用、queuedRequest 批量提交、CircuitBreaker.execute 包装请求、Python 的 with_retry 包装 find_v0。对文档创建或签名动作,重试前应先确认当前状态,避免重复操作。

适用场景:开发环境用合成文档在受控并发下压测;批量文档创建;监控 429、延迟与完成率;对上游故障做优雅降级。

限制:资料未提供具体每分钟配额、各计划文档数量上限、定价以外的计费细节,也未给出官方限流响应头或重试建议值;文中参数均为示例默认值,需按实际场景调整。后续可参考 documenso-security-basics 做安全配置。