Docusign API: поиск заданного конверта / конвертов с использованием настраиваемого поля

Question

Как составить URL-адрес get, чтобы получить конверт или конверты, содержащие заданное пользовательское поле. Я попытался составить URL-адрес get, как показано ниже, но не получил желаемых результатов (я пытался следовать документации здесь -> https://developers.docusign.com/esign-rest-api/reference/Envelopes/Envelopes/listStatusChanges, но я думаю, что я не передаю настраиваемое поле в строку запроса правильно

https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID_NUMBER/envelopes?from_date=2019-12-05&folder_types=sentitems&status=completed& custom_field = [SignerEmail = john. doe@email.com]

Answer 1

Вы используете правильный вызов API. Попробуйте это без квадратных скобок и закодируйте значение.

Например

... &custom_field=SignerEmail%3Djohn.doe%40email.com

Выше не проверено. Если это не сработает, мы углубимся в это

Важно: пытаетесь ли вы найти конверты с полем custm_envelop_field (метаданные), который вы создали и назвали «SignerEmail» ?? Если это так, то вышеприведенный способ является способом go.

. Если вы ищете конверты с адресом электронной почты получателя подписи john@doe.com, попробуйте общий поиск, как предлагает Inbar. Если это не сработает, вам может понадобиться еще одна тактика c.

Answer 2

Предлагаем прочитать здесь: https://developers.docusign.com/esign-rest-api/guides/concepts/envelopes/search параметр называется search_text и будет искать все, включая настраиваемые поля. Там нет необходимости отдельно указывать пользовательские поля. Как то так:

https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID_NUMBER/envelopes?search_text=[SignerEmail=john.doe@email.com]