通过DocumentId查找Envelope？

Question

我刚开始使用DocuSign REST API（创建与我公司产品的概念验证集成），并试图将我的头脑包裹在一切。有几件事我找不到太多信息：

1. 创建信封时，documentId是否重要？我假设如果有多个文档，则documentId每个文档需要不同。是否在其他地方使用？

2. 我想定期查看信封的审核事件。如果我可以用documentId查找信封（或直接进入审计事件而不查找信封），这将会容易得多。这可能吗？

我们的产品已存储文档，因此具有documentId - 因此这是我在创建信封时使用的ID。我想做的是，我在产品中查看的任何文件都会检查是否有未完成的信封待处理。然后我不需要在我们的系统中存储任何与DocuSign相关的数据（即envelopeId）。

我可以通过用于创建信封的documentId查找信封吗？

Answer 1

1. documentId是客户定义的属性，可以帮助您标记用于给定信封的文档。如果你想跟踪你在信封中提供的文件（它听起来像你），那么你可以使用它来唯一地识别底层文档，如果你已经有一个生成了documentIds的系统，那么应该让事情变得更容易

2. 没有办法通过documentId检索信封信息。最佳解决方案最有可能存储一个简单的表格，将documentIds链接到envelopeIds，然后在您要搜索的documentId使用链接的envelopeId来检索其状态。

但是，您应该注意，某些API调用存在某些API调用限制，请求信封状态就是其中之一。您不得每15分钟对给定信封上的状态请求超过1次。相反，如果您想跟踪实时状态，建议使用DocuSign Connect模块（DocuSign Connect会在发生状态时立即向您发送状态，而不是每隔一段时间轮询状态）。

有关API调用限制的更多信息，请查看“Go Live”部分下的DocuSign开发人员中心的API最佳实践文档： https://www.docusign.com/developer-center/go-live/certification