Ищете пример Docusign REST API v2 Получить изменения статуса конверта

Question

Я пытаюсь просмотреть все конверты и их статус, но для него нет REST API Explorer, и пример в документации не работает, я предполагаю, потому что это не содержит по крайней мере from_date. Я не вижу, как добавить параметры поиска в запрос на получение. В каком формате должна находиться дата? Являются ли параметры поиска в теле запроса или каким-то образом добавлены в URL?

После нескольких попыток я понял это. Используйте GET для baseUrl/envelopes? From_date = 2013-07-18 status = создан, например, если вы хотите увидеть все конверты, созданные после или после 7/18/13 со статусом «created». Я также понял, что если вы оставите параметр «status», он вернет все статусы, кроме «created», поэтому, если вы хотите их увидеть, вы должны добавить этот параметр к URL-адресу. У вас ДОЛЖЕН иметь параметр «from_date» или использовать параметр «envelopeId», в противном случае оба они не будут работать. Вы не можете просто искать статус = завершено. Надеюсь это поможет!

Answer 1

Вы видели API-интерфейс DocuSign Walkthrouhgs? Есть отличный пример того, как фильтровать конверты на основе как from_date, так и списка состояний. Как вы поняли, параметры добавляются как параметры URL (в отличие от параметров в теле запроса).

Этот API Пошаговое руководство, в частности, показывает, как это сделать с помощью FROM_DATE точно, неделю назад с момента, когда код выполняется:

http://iodocs.docusign.com/APIWalkthrough/getEnvelopeStatus

Полученный URL, если запустить сегодня 7/27/13 например, будет выглядеть примерно так:

https://demo.docusign.net/restapi/v2/accounts/221765/envelopes?from_date=07%2F20%2F2013&status=created,sent,delivered,signed,completed

Обратите внимание, как URL закодирован дата 7/20/2013 (т.е. одна неделя назад).