Rest 按文档ID查找信封?

Rest 按文档ID查找信封?,rest,docusignapi,Rest,Docusignapi,我刚刚开始使用docusignrestapi(创建一个与我公司产品的概念验证集成),我正试着对所有事情了如指掌。有几件事我找不到太多的信息: 创建信封时,documentId是否重要?我假设如果有多个文档,则每个文档的documentId都需要不同。它在别的地方用过吗 我想定期检查审计事件是否有信封。如果我可以用documentId来查找信封(或者直接进入审计事件而不查找信封),那会容易得多。这可能吗 我们的产品已经存储了文档,因此有一个文档ID——这就是我在创建信封时使用的ID。我想做的是,无

我刚刚开始使用docusignrestapi(创建一个与我公司产品的概念验证集成),我正试着对所有事情了如指掌。有几件事我找不到太多的信息:

  • 创建信封时,
    documentId
    是否重要?我假设如果有多个文档,则每个文档的
    documentId
    都需要不同。它在别的地方用过吗

  • 我想定期检查审计事件是否有信封。如果我可以用
    documentId
    来查找信封(或者直接进入审计事件而不查找信封),那会容易得多。这可能吗

  • 我们的产品已经存储了文档,因此有一个
    文档ID
    ——这就是我在创建信封时使用的ID。我想做的是,无论我在我们的产品中看到什么文档,都要检查是否有未完成的信封等待处理。这样,我就不需要在我们的系统中存储任何与DocuSign相关的数据(即
    envelopeId

    我可以通过创建信封时使用的
    documentId
    查找信封吗?

  • documentId
    是客户机定义的属性,用于帮助您标记用于给定信封的文档。如果您想跟踪信封中提供的文档(听起来像是这样),那么您可以使用它来唯一地标识底层文档,如果您已经有一个生成DocumentID的系统,那么这将使事情变得更简单

  • 不,无法通过
    documentId
    检索信封信息。最好的解决方案很可能是在您这边存储一个简单的表,将
    documentId
    链接到
    envelopeId
    ,然后给定要搜索的
    documentId
    ,使用链接的envelopeId检索其状态

  • 不过,您应该注意,对于某些API调用,存在特定的API调用限制,请求信封状态就是其中之一。您不允许每15分钟在给定信封上请求状态超过1次。相反,如果您希望跟踪实时状态,建议使用该模块(DocuSign Connect会在状态发生时立即将状态推送给您,而不是您每隔一段时间轮询一次状态)

    有关API调用限制的更多信息,请查看DocuSign Developer Center“上线”部分下的API最佳实践文档: