简短回答:DocuSign 与 HelloSign 采用不同的限额模型
DocuSign 与 HelloSign(现为 Dropbox Sign)对 API 用量的计量方式完全不同,因此并不存在一个可以直接对比的"API 限额"数字。DocuSign 官方文档描述的是每个账户的每小时请求上限(默认每小时 3,000 次,通过 X-RateLimit-Limit 响应头暴露)、30 秒突发上限(开发环境 200 次、生产环境 500 次),以及严格的轮询纪律——每个信封的状态查询每 15 分钟不超过一次。HelloSign / Dropbox Sign 官方文档描述的则是每分钟请求速率(标准请求每分钟 100 次、高级端点 25 次、测试模式 10 次);更关键的是,它把端点按计划层级划分:嵌入式签署与批量发送在 Standard 计划解锁,模板编辑 API 在 Premium 计划解锁。
对于要拿这两个 API 承载每月数千份合同的开发者来说,可靠的答案不是一个营销数字,而是一套核实流程:读官方文档、检查自己的响应头、做压测。两个概念必须分开:速率限制(每分钟或每小时允许多少次 API 请求——这是技术性节流)和信封配额(你的计划每月包含多少份文档——这是商业性额度)。团队选错供应商,往往就是因为把这两者混为一谈。账单侧的问题,我们关于 DocuSign 与 Dropbox Sign API 成本与定价层级对比的评测展示了这两个数字如何变成合同条款。
DocuSign API 限额:官方文档到底怎么说
DocuSign 的权威说明集中在两处:平台级的 API 资源限额页面 和 eSignature 专属的 规则与资源限额页面。按当前文档,机制如下:
- 每账户每小时上限。 所有 DocuSign API 都会将每个账户限制为每小时一定次数的请求,通过
X-RateLimit-Limit返回;文档默认值是 3,000 次,每小时整点刷新。符合条件的账户可由管理员通过 API Usage Center 提高该上限。 - 30 秒突发上限。 开发环境每 30 秒 200 次,生产环境 500 次(
X-BurstLimit-Limit)。 - 单信封纪律。 每个信封每小时的 GET/PUT 请求受限,单个应用对同一信封的状态查询最多每 15 分钟一次;反复轮询会被标记,并可能在 Go-Live 审核中导致应用失败。文档推荐用 DocuSign Connect(webhooks)替代轮询,并建议每次信封创建或更新调用约 5 次以内。
- 上传并发限制。 同一文档的并发上传会被节流——文档描述为最近一小时内同一文档最多 70 个进行中的上传。
DocuSign 可能随时修订这些数字,因此请以在线 rules-and-limits 页面以及你自己账户上的 X-RateLimit-* 响应头为事实来源。如果你已经通过 API 拉取已签署文档数据,从已签署文档中提取表单字段数据一文介绍了对轮询友好的做法。
HelloSign(Dropbox Sign)API 限额:官方文档到底怎么说
HelloSign 在 Dropbox 收购后更名为 Dropbox Sign,权威文档位于 developers.hellosign.com/docs/overview。当前机制如下:
- 每分钟请求速率。 标准请求每分钟最多 100 次,高级请求每分钟 25 次;测试模式每分钟 10 次。限额通过
X-Ratelimit-Limit、X-Ratelimit-Limit-Remaining和X-Ratelimit-Reset头暴露;超限时返回 HTTP 429 与exceeded_rate错误。 - 端点按计划分级。 这是与 DocuSign 的结构性差异。Essentials 解锁核心发送(
signature_request/send、send_with_template);Standard 解锁批量发送与嵌入式签署(bulk_send_with_template、create_embedded、create_embedded_with_template、bulk_create_embedded_with_template以及unclaimed_draft系列);Premium 解锁嵌入式模板编辑(template/create_embedded_draft、template/update_files)。 - 测试模式与超额。 几乎所有功能都可以在免费账户上用
test_mode: true测试(带水印、不具法律效力)。频繁触发速率限制会收到邮件警告,并可能导致封禁;如需提高额度可申请。
该页面没有说明的,是每个计划的每月信封配额——那是 Dropbox 定价与销售材料里的商业数字,因此博客上任何具体的每月信封数字,在获得书面确认之前都应视为未经证实。对日常签署流程来说,HelloSign 与 DocuSign 的签署流程对比是很有用的补充阅读。
嵌入式签署与模板 API:两家的计划在哪里分岔
对产品团队来说,最咬人的限额通常不是吞吐量,而是你的计划开放了哪些端点。Dropbox Sign 的分层很明确:在自己的应用内嵌入签署至少需要 Standard(create_embedded、create_embedded_with_template),以编程方式创建或编辑模板需要 Premium(template/create_embedded_draft、template/update_files)。批量发送同样在 Standard。评估用 Dropbox Sign 做嵌入式产品的团队,必须首先核对计划层级,而不仅是请求速率。
DocuSign 把同样的能力——嵌入式签署、批量发送、PowerForms、模板、Connect webhooks——都组织在 eSignature API 面上,但你的订阅包含哪些,由协商确定的商业计划决定,而不是以固定清单发布。可靠的确认方式是在开发者沙箱里测试、跑一遍 DocuSign 的 Go-Live 审核,并阅读自己的计划文档。想按地区了解,面向 APAC 团队的 DocuSign 与 Dropbox Sign 对比说明了这些能力差异在实际中的表现。
这些限额对高吞吐量与批量签署意味着什么
当每月要处理数千份合同时,把两家的机制翻译成设计约束:
- 用批量端点,而不是逐信封循环。 Dropbox Sign 的
bulk_send_with_template(Standard)是官方的批量路径;DocuSign 文档建议每个信封约 5 次调用、用 Connect 查状态。轮询循环是触发 15 分钟规则和每小时规则的最快方式。 - 按突发设计,而不是按平均设计。 一个在两分钟内发出数千次调用的批处理任务,会在业务配额耗尽之前先撞上 DocuSign 的 30 秒突发上限(演示 200 / 生产 500)和每小时上限。把工作摊开,或通过 API Usage Center 提高每小时上限。
- 用 webhooks 替代轮询。 DocuSign Connect 和 Dropbox Sign 回调,是两家平台自己给出的状态检查方案。
- 把配额与速率分开。 每月几千份合同在信封层面并不算多,但每份合同可能产生 20–50 次 API 调用(创建、收件人更新、文档下载、状态查询)。真正撞上限额的是这个乘数,而不是原始合同数量。
- 压测时要尊重测试模式节流。 Dropbox Sign 每分钟 10 次的测试上限意味着,贴近真实的压测需要付费账户并逐步提升速率。
对于轻量、偶发的使用场景,算法又不一样了——一次性签署场景的最佳 DocuSign 替代方案讨论了什么时候完整的 API 平台属于杀鸡用牛刀。
对比表与核实清单
| 维度 | DocuSign eSignature API | HelloSign / Dropbox Sign API |
|---|---|---|
| 默认请求窗口 | 每账户每小时上限(默认 3,000 次/小时,X-RateLimit-Limit) | 每分钟速率(标准 100 次、高级 25 次、测试 10 次) |
| 突发上限 | 每 30 秒 200 次(演示)/ 500 次(生产) | 通过 429 exceeded_rate 说明 |
| 状态轮询 | 每信封每 15 分钟 ≤1 次 GET;建议 Connect | 受每分钟速率约束;提供回调 |
| 嵌入式签署 | 在 eSignature API 面内;由商业计划决定 | Standard 计划 |
| 批量发送 | 由计划/协商决定 | Standard 计划 |
| 模板编辑 API | 由商业计划决定 | Premium 计划 |
| 核实位置 | resource-limits 页面、rules-and-limits 页面、API Usage Center、响应头 | developers.hellosign.com/docs/overview、响应头、销售报价 |
下单之前先过一遍清单:(1)阅读两家供应商当前官方的速率限制页面;(2)读取你自己账户的 X-RateLimit-* 响应头;(3)从定价页或客户经理那里书面确认每月信封配额;(4)确认你需要的具体端点(嵌入式、批量、模板)所在的计划门槛;(5)在生产级账户上跑一次受控压测,留意 429 和 HOURLY_APIINVOCATION_LIMIT_EXCEEDED;(6)在动手开发前就按 webhooks 而非轮询来设计;(7)在评估文档里给核实过的数字盖上日期戳,让工程和采购共享同一个事实来源。
第三个基准:Nota Sign 的按量模式
如果上面的限额对比让你想再找一个选项,可以把 Nota Sign 放上同一条测试线。它背后是法大大(FaDaDa)——连续多年被 IDC 评为中国电子签名软件市场第一——平台完成的签署在 100 多个国家和地区具有法律效力,亚太合规覆盖从 iAM Smart、Singpass 一直到 SES/AES/QES 各保障级别。
与上面两家相比,真正的分野在商业模型:没有按席位授权。工程团队就算发送人翻倍,成本也不随之翻倍;方案按月度文档量设计,正适合本文讨论的高吞吐批量场景。用你自己的负载画像去实测——向 Nota Sign 团队索取按量报价。









