2017-02-18 101 views
1

我想每隔15分鐘輪詢DocuSign以獲取信封狀態更新。 我使用listEnvelopes()方法進行一些調整描述hereDocuSign Rest API輪詢狀態更新

它們設定較低的時間約束,如:

// set from date to filter envelopes (ex: Dec 1, 2015) 
options.setFromDate("2015/12/01"); 

這將讓所有的信封自2015年12月1日。但是,在我的應用程序中,我想每隔15分鐘(按DocuSign文檔)通過Quartz查詢最近20分鐘的窗口,並使用fromDate根據當前時間動態計算。

所以我格式化的日期:根據documentation

但是(YYYY-MM-DD HH毫米),我可以得到的所有信封返回的唯一方法是通過設置沒有fromdate財產,開始一天的。 (2017-02-17 00:00)

如果我在日期字符串中添加分鐘或小時數,我無法獲得任何結果(2017-02-17 20:56) 我已更新Docusign的設置時區全部到東部時間,因爲我的應用程序是如何配置的。它似乎總是忽略小時和分鐘值,但文檔建議每15分鐘輪詢一次。我錯過了什麼嗎?

我相信我可以從信封本身獲取時間信息(通過使用envelopeId獲取)。這樣我可能會知道DocuSign認爲它是什麼時候。

回答

3

這裏是FROM_DATE爲listStatusChanges API格式

options.setFromDate("2017-02-17T20:56:00.000Z") 

你的GET請求看起來像這樣

GET /v2/accounts/{accountId}/envelopes?from_date=2017-02-17T20:56:00.000Z 

提示:這是更有效地使用Docusign Webhooks用於獲取信封狀態如果您的計劃支持它,則更改。

發送的信封的狀態可以通過DocuSign webhook系統或通過輪詢來確定。強烈建議使用Webhook:當信封狀態發生變化時,它們會爲您的應用程序提供最快的更新。相比之下,DocuSign將信封狀態的輪詢時間限制爲每15分鐘或更短一次。

當使用webhook時,DocuSign會使用通知XML消息通過您提供的URL調用您的應用程序。

+0

感謝您對答案和問題的幫助。星期一我會試試這個。上面的鏈接(配方)說明了什麼應該稱爲面向對象的api方法?我的手與投票方法有關。 –

+0

它被稱爲Docusign Connect或Docusign Webhooks –

+0

不是您的鏈接,我的鏈接。 CoreRecipes類的實現。哪裏沒有明確的GET請求 –