DocuSign Rest API狀態更新輪詢

Question

我試圖每15分鍾輪詢一次DocuSign以獲取信封狀態更新。 我正在使用此處描述的listEnvelopes（）方法進行一些調整：

他們設置較低的時間限制，如：

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

自2015/12/01以來，這將獲得所有信封。

但是，在我的應用程序中，我想通過Quartz每隔15分鍾（根據DocuSign文檔）輪詢最近20分鍾的窗口，其中fromDate將根據當前時間動態計算。

所以我根據文檔格式化了日期（yyyy-MM-dd HH：mm）

但是，我可以獲得任何返回信封的唯一方法是將fromDate屬性設置為start of day。 （2017-02-17 00:00）

如果我在日期字符串中添加分鍾或小時，我將無法獲得任何結果。（2017-02-17 20:56）我已將更新Docusign的時區設置更新到東部時間，因為我的應用程序的配置方式如何。 它似乎總是忽略小時和分鍾值，但文檔建議每15分鍾輪詢一次。 我錯過了什么嗎？

我相信我可以從信封本身獲取時間信息（通過使用envelopeId獲取）。 這樣我可能知道DocuSign認為它是什么時候。

Answer 1

以下是listStatusChanges API的from_date格式

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會通過您提供的URL使用通知XML消息調用您的應用程序。