Docusign 投票政策

Question

我发现轮询限制及其相关文档对于什么是轮询有点含糊，所以我希望有人可以帮助我了解我当前的流程是否会遇到问题。

我的理解是，轮询被视为请求信封状态，但以每个 document/envelope 为基础，您不应在发送另一个请求后不到 5 分钟内请求。

所以我的问题是：

我的集成正在为每个交易创建一个新的 envelope/new 文档，一旦文档被签名，我就会请求文档状态。

如果请求不是相隔 5 分钟并且每次都考虑它是一个新的 document/envelope，我对这个流程会有问题吗？

Answer 1

DocuSign 对投票信封设置了 API 速率限制以及每个帐户的总体每小时限制：

给定帐户每小时最多允许 1,000 API 次调用。此外，每 15 分钟每个唯一信封的状态请求不得超过 1 个。换句话说，如果您对信封发出 GET 状态请求，您的集成将需要等待至少 15 分钟才能再次请求同一信封的状态。

您应该考虑的几件事：

1. 您可以使用 DocuSign Connect 模块在给定事件发生时立即向您推送状态、文档和其他元数据，而不是经常轮询 DocuSign 服务。 （注：DocuSign Connect 是付费模块）
2. 您还可以在信封中使用 eventNotification 属性 让 DocuSign 服务将数据推送给您（这使用与 Connect 相同的引擎，但免费）。

所以您在这里有几个选择 - 您可以在同一个信封上每 15 分钟或更长时间轮询一次状态，或者您可以使用两种方法之一让 DocuSign 在确定后立即将数据推送给您事件发生。

最后，API 文档的 THIS PAGE 更详细地解释了速率限制。您还可以使用相同的 link 来了解有关 eventNotification 功能的更多信息，只需在搜索栏中搜索该术语即可。