Docusignapi 如何确定文档是否已签名

在我的returnUrl处理程序中，我使用的是列表文档

在返回的数组中，如何确定文档是否已签名

---

谢谢

从DocuSign返回的URL有一个事件参数，如下所示：

http://www.acme.com?event=signing_complete

签名完成意味着它已签名

---

在文章的“确定收件人操作”部分中有其他事件的完整列表。

您的返回url处理程序将使用查询参数

event

调用，如Inbar的回答中所述

但是，您应该不要使用查询参数来做出业务决策，因为坏人可以很容易地调用您的返回url，并简单地添加一个事件=signing\u complete查询参数——欺骗您的应用程序

相反，当您的应用程序需要知道信封是否已签名时，它有两类选项：

询问文件 您的应用程序可以调用该方法来确定信封的当前状态。其他API方法也可用于此功能

设计应用程序时，不要每15分钟就特定信封多次调用DocuSign，因为这种行为被视为轮询，是不允许的

Webhook:DocuSign将调用您的应用程序 您可以使用DocuSign设置webhook，以便在信封完成（由所有签名者签名等）后，eSignature平台将调用您的应用程序

使用DocuSign webhook HMAC功能可确保通知消息来自DocuSign（未被伪造），并且在传输过程中未被更改

通过使用AWS或等效软件，您可以轻松地在防火墙后面接收通知消息，而无需更改防火墙。AWS每月不会向您收取第一个百万条通知消息的费用。请参阅github.com/docusign上的connect-*repos

仪表盘

---

如果您的应用程序希望向业务决策者展示关于信封状态的仪表板，那么依赖

事件

查询参数就可以了。但是，在你的应用程序做任何真正需要花钱的事情之前，比如启动向客户提供的商品或服务，请确保信封已经使用上述两种技术之一签名

事件

查询参数不应用于业务决策，因为聪明的坏人可能会欺骗它。更多信息请参见我的答案。更多信息请参见我的答案。