Опрос пользователей DocuSign Rest для обновлений статуса

Question

Я пытаюсь опросить DocuSign каждые 15 минут, чтобы получить обновления статуса конверта. Я использую listEnvelopes() метод, описанный here с некоторыми изменениями:

Они устанавливают нижнее ограничение времени, как:

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

Что бы получить все конверты с момента 2015/12/01.

Однако в моем приложении я хотел бы опросить каждые 15 минут (согласно документации DocuSign) через Quartz для окна за последние 20 минут с помощью параметра fromDate, который будет динамически вычисляться на основе текущего времени.

Так что я отформатировал дату (гггг-мм-дд чч: мм) в соответствии с documentation

Однако, единственный способ, которым я могу получить любые конверты Возвращается, установив свойство FromDate на начало дня. (2017-02-17 00:00)

Я не могу получить никаких результатов, если добавить минуты или часы к дате String. (2017-02-17 20:56) Я обновил настройки Docusign для timeZones все к восточному времени, как то, как настроено мое приложение. Кажется, что всегда игнорируются значения часов и минут, но документация рекомендует опрос каждые 15 минут. Я что-то упускаю?

Я считаю, что я могу получить информацию о времени из самого конверта (путем выбора с помощью envelopeId). Таким образом, я мог бы знать, в какое время DocuSign думает, что это так.

Answer 1

Вот формат 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 или путем опроса. Рекомендуется использовать Webhooks: они предоставляют вашему приложению самые быстрые обновления при изменении статуса конверта. Напротив, DocuSign ограничивает опрос для статуса конверта раз в 15 минут или менее.

При использовании webhook DocuSign обращается к вашему приложению через предоставленный вами URL с уведомлением XML-сообщения.