DocuSign dynamic/multiple 网络钩子网址
DocuSign dynamic/multiple webhook urls
是否有任何 guidelines/recommendations 的 Webhook URL 可用于设置事件通知?
我正在考虑使用这样的东西 - /webhook/v1/{uniqueAppID}。每个信封的 uniqueAppID 都会更改,我在创建信封时动态构造 URL 并将其设置为 EventNotification 对象。
唯一的应用程序 ID 用于跟踪来自 DocuSign 的响应,因此如果在解析响应时有任何问题,我会知道我收到了哪个 envelope/app id 的通知。
我读到只有在从 webhook 收到成功确认后,系统才会重试失败的传送,在我的情况下,就像有多个 webhook 一样。此设置会导致重试失败时出现任何问题吗?将 url 设置为 /webhook/v1?uniqueAppID={uniqueAppID} 有帮助吗?
谢谢
很好的问题。
首先,您不必使用任何类型的 endpoint/URL 方案。你可以让他们都去一个地方。您从有效负载中的 DocuSign 获得的信息将使您了解有关信封的所有信息,如果您需要其他信息 - 您可以调用 API 来确定这一点。
但是,我同意,如果您需要此信息,使用不同的端点会给您更大的灵活性。此外,如果它是不同的应用程序,理论上您可以单独部署它们,因此端点代码会发生变化而不会影响其他应用程序。
至于重试,这是为了防止 DocuSign 没有从您的网络服务器获得 200、201 或其他 HTTP 响应。如果 DocuSign 收到 401 或 500 等。如果未收到任何响应,DocuSign 将在 24 小时内重试。
这不应影响您对设计的决定。
最后要考虑的一件事是,您不能落后于 firewall/VPN 等。强烈建议您为您的应用考虑 public 云提供商(Azure、AWS、Google)以避免网络问题。
使用信封级 webhook 时,触发器和目标 URI 嵌入到该信封中。在信封进入 'sent' 或 'completed' 等预定义状态后,回写将以您提供的 URI 为目标。除非您有意更改它,否则它应该保持特定于信封。
这与我们典型的 Connect 设置不同,后者每个侦听器都有一个 URI,信封回写将在处理时定向到侦听器 URI。
任何后续失败或重试尝试都将遵循此处概述的标准准则:
是否有任何 guidelines/recommendations 的 Webhook URL 可用于设置事件通知? 我正在考虑使用这样的东西 - /webhook/v1/{uniqueAppID}。每个信封的 uniqueAppID 都会更改,我在创建信封时动态构造 URL 并将其设置为 EventNotification 对象。 唯一的应用程序 ID 用于跟踪来自 DocuSign 的响应,因此如果在解析响应时有任何问题,我会知道我收到了哪个 envelope/app id 的通知。
我读到只有在从 webhook 收到成功确认后,系统才会重试失败的传送,在我的情况下,就像有多个 webhook 一样。此设置会导致重试失败时出现任何问题吗?将 url 设置为 /webhook/v1?uniqueAppID={uniqueAppID} 有帮助吗?
谢谢
很好的问题。 首先,您不必使用任何类型的 endpoint/URL 方案。你可以让他们都去一个地方。您从有效负载中的 DocuSign 获得的信息将使您了解有关信封的所有信息,如果您需要其他信息 - 您可以调用 API 来确定这一点。 但是,我同意,如果您需要此信息,使用不同的端点会给您更大的灵活性。此外,如果它是不同的应用程序,理论上您可以单独部署它们,因此端点代码会发生变化而不会影响其他应用程序。 至于重试,这是为了防止 DocuSign 没有从您的网络服务器获得 200、201 或其他 HTTP 响应。如果 DocuSign 收到 401 或 500 等。如果未收到任何响应,DocuSign 将在 24 小时内重试。 这不应影响您对设计的决定。 最后要考虑的一件事是,您不能落后于 firewall/VPN 等。强烈建议您为您的应用考虑 public 云提供商(Azure、AWS、Google)以避免网络问题。
使用信封级 webhook 时,触发器和目标 URI 嵌入到该信封中。在信封进入 'sent' 或 'completed' 等预定义状态后,回写将以您提供的 URI 为目标。除非您有意更改它,否则它应该保持特定于信封。
这与我们典型的 Connect 设置不同,后者每个侦听器都有一个 URI,信封回写将在处理时定向到侦听器 URI。
任何后续失败或重试尝试都将遵循此处概述的标准准则: