如何使用DocuSign检查文档的状态？

Question

我们将使用DocuSign API签署我们的文件。上传文档以进行签名/拒绝后，我们有两种方式来获取文档的状态（已签名或已拒绝）：

1. 通过从我们的WCF服务重复调用DocuSign API来检查文档的状态（每小时限制为1000个呼叫，但我们可以将其限制为每小时每个文档1个呼叫）
2. 发送带有信封的公共URL，只要文档状态发生变化，就会调用该信封？ （https://www.docusign.com/p/RESTAPIGuide/Content/REST%20API%20References/Send%20an%20Envelope.htm）    此方法需要使用我们环境中的公共URL更新名为“eventNotification”的参数。

我想知道哪一个更好地接近架构？平均而言，我们预计每月会有50份文件签署。

Answer 1

通常，最佳做法是方法＃2 - 即配置DocuSign Connect，以便每次发生一个指定的Envelope事件时，它会自动发送通知（指向您指定的端点）。这种方法有很多优点，包括：

• 使用Connect不会计入每小时限制的1000次API调用
• 通知将以（相对）实时发送/接收
• 使用Connect不需要您通过“API认证”流程

DocuSign Connect服务指南（https://10226ec94e53f4ca538f-0035e62ac0d194a46695a3b225d72cc8.ssl.cf2.rackcdn.com/connect-guide.pdf）介绍了如何配置/实施Connect。您需要进行一些自定义开发来构建将从DocuSign接收和解析XML通知的“侦听器”，但这很简单，GitHub上提供了示例代码（有几种不同的语言）。 / p>

注意 ：如果您希望DocuSign自动发送所有信封的通知（对于您指定的发件人），您只需配置Connect即可通过DocuSign Web控制台（首选项＆gt;＆gt;连接）在帐户级别，而不必指定 eventNotification 作为每个创建信封的一部分 API请求。如果您使用此方法，则可以通过DocuSign Web控制台（首选项＆gt;＆gt;连接）进行任何未来的配置更改，而不必进行代码更改。即，如果您想为其他事件添加通知，请自行包含或排除文档等。