当 webhook 失败时,Docusign 信封通知会发生什么情况?
What happens to Docusign envelope notifications when webhook fails?
我正在尝试在我公司的系统中实施 Docusign。我想出了如何使用 REST API 以及如何实现 webhook 来接收信封事件通知。
但是我想知道当 webhook 返回错误时会发生什么? Docusign 会在一段时间后重新发送通知吗?我在文档中找不到任何内容。
我是否必须与 webhook 一起实施池机制,或者有更好的方法来管理这种情况?
编辑:
所以这是我在失败日志中看到的:
一个实际上被重新发布了,但另一个没有。也许错误代码会有所不同?第一个是 5xx 服务器端错误,另一个最初是 404,第二次也是 404。
但是 DocuSign 并没有立即尝试第二次尝试而是等待 24 小时?
以下是我如何在 C# 中配置通知信封:
envelope.EventNotification = new EventNotification()
{
Url = _webhookUrl,
RequireAcknowledgment = "true",
LoggingEnabled = "true",
IncludeEnvelopeVoidReason = "true",
IncludeDocuments = "false",
IncludeCertificateOfCompletion = "false",
IncludeCertificateWithSoap = "false",
IncludeDocumentFields = "false",
IncludeHMAC = "false",
IncludeSenderAccountAsCustomField = "false",
IncludeTimeZone = "false",
UseSoapInterface = "false",
EnvelopeEvents = new List<EnvelopeEvent>() { new EnvelopeEvent("completed"), new EnvelopeEvent("declined"), new EnvelopeEvent("voided") },
RecipientEvents = new List<RecipientEvent>() { new RecipientEvent(null, "Completed") }
};
如果选择了“需要确认”选项并且在接下来的 24 小时内未能确认发布消息,则该消息将返回队列并且系统将在收到成功的确认后重试传递。
这是因为没有确认或错误的 HTTP 结果。如果任何时候出现良好的 HTTP 结果,连接日志都会更新,消息会从队列中删除。
最多重试十次。
我正在尝试在我公司的系统中实施 Docusign。我想出了如何使用 REST API 以及如何实现 webhook 来接收信封事件通知。 但是我想知道当 webhook 返回错误时会发生什么? Docusign 会在一段时间后重新发送通知吗?我在文档中找不到任何内容。 我是否必须与 webhook 一起实施池机制,或者有更好的方法来管理这种情况?
编辑:
所以这是我在失败日志中看到的:
一个实际上被重新发布了,但另一个没有。也许错误代码会有所不同?第一个是 5xx 服务器端错误,另一个最初是 404,第二次也是 404。
但是 DocuSign 并没有立即尝试第二次尝试而是等待 24 小时?
以下是我如何在 C# 中配置通知信封:
envelope.EventNotification = new EventNotification()
{
Url = _webhookUrl,
RequireAcknowledgment = "true",
LoggingEnabled = "true",
IncludeEnvelopeVoidReason = "true",
IncludeDocuments = "false",
IncludeCertificateOfCompletion = "false",
IncludeCertificateWithSoap = "false",
IncludeDocumentFields = "false",
IncludeHMAC = "false",
IncludeSenderAccountAsCustomField = "false",
IncludeTimeZone = "false",
UseSoapInterface = "false",
EnvelopeEvents = new List<EnvelopeEvent>() { new EnvelopeEvent("completed"), new EnvelopeEvent("declined"), new EnvelopeEvent("voided") },
RecipientEvents = new List<RecipientEvent>() { new RecipientEvent(null, "Completed") }
};
如果选择了“需要确认”选项并且在接下来的 24 小时内未能确认发布消息,则该消息将返回队列并且系统将在收到成功的确认后重试传递。 这是因为没有确认或错误的 HTTP 结果。如果任何时候出现良好的 HTTP 结果,连接日志都会更新,消息会从队列中删除。 最多重试十次。