Docusign事件通知

Question

我正在为Docusign事件通知实现一个侦听器。对于每个新事件，Docusign都会发送一个新的DosuSignEnvelopeInformation对象。我的问题是，该对象是否仅包括新更改的状态，或者例如，如果其中一个收件人状态没有更改，它仍将包括在内。此外，由于对其中一个收件人状态的更改不一定会更改信封状态，因此通知是否始终包含信封状态？

Answer 1

我建议您看一下XSD：https://www.docusign.net/api/3.0/schema/dsx.xsd

connect发送的类型是DocuSignEnvelopeInformation，它由EnvelopeStatus和DocumentPDF对象组成，这两个对象都在这个XSD中定义了自己的模式。简而言之，connect XML是向您发送通知时信封的快照，该快照将包括所有收件人信息。

在沙箱环境中，您可以启用启用日志记录的DS Connect测试配置，以查看您将接收的消息类型。

Answer 2

绝对正确，请记住，为了节省演示环境中的空间，我们没有在日志中包含PDF字节流，因为它没有逻辑，这意味着它只是一堆字节。如果你想看它，你可以使用webhook.com (免费)或其他类似的工具。

Answer 3

接口中的连接服务和相关的eventNotification节点是事件驱动的。它们不发布事件，而是发布信封的完整当前状态，包括信封状态、所有收件人的收件人状态等。该服务总是发布current状态，因此两个“接近”事件可能会触发一个合并的状态发布，或者两个关闭的发布。但是，最后一次发布将包含最新的更改。如果您获得“已重新发布”状态(例如，由于确认失败或直接触发)，则它仍然是当前状态，而不是原始发布时的“旧”状态。