如何使用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上使用示例代碼（使用幾種不同的語言）。

注：如果你想的DocuSign自動發送通知所有信封（您指定的發件人），你可以在通過的DocuSign Web控制檯的帳戶級別配置連接（首選項> > Connect），而不必指定eventNotification作爲每個創建信封 API請求的一部分。如果您使用這種方法，則只需通過DocuSign Web控制檯（首選項>>連接）即可進行任何將來的配置更改，而無需更改代碼。即如果您想爲其他事件添加通知，請自行包含或排除文檔等。