Лучшая практика - вызов API или вызов клиентской библиотеки C #

Question

Мы интегрируем новую систему с DocuSign.Система построена с использованием объектов C #.

Мой вопрос: каков наилучший способ взаимодействия с DocuSign - вызывать методы веб-API DocuSign напрямую или включать клиентскую библиотеку DocuSign C # в качестве ссылки на наш код и вызывать это напрямую?

Спасибо!

Answer 1

Я рекомендую использовать клиентскую библиотеку C #. Это сэкономит ваше время и сделает его очень простым в использовании. Код для него также общедоступен в github, поэтому, если по какой-то причине вы хотите раскошелиться и использовать его таким образом, вы можете сделать это тоже.

Answer 2

DocuSign C # SDK избавит вас от необходимости:

• сериализация объектов запроса в структуру JSON
• отправка запроса HTTPS
• десериализация объектов ответа в объекты C #.

Также включает вспомогательные методы для реализации потока OAuth JWT Grant.

Это все веские причины для использования SDK.

Если вы ожидаете, что будете регулярно отправлять документы размером более 20 МБ, то вы можете захотеть реализовать вызов Envelopes :: create call самостоятельно. Зачем? Поскольку текущая версия SDK BASE64 кодирует документы, которые вы загружаете в DocuSign.

Если вы реализуете вызов Envelopes :: create самостоятельно, вы можете отправлять документы в двоичном виде. Это не так просто сделать, но важно, если у вас очень большие исходные документы. Пример отправки в двоичном режиме.

Добавлена ​​

Ограничения размера: 25 МБ на вызов API. Но документ (ы) в вызове API, закодированные в BASE64, имеют много накладных расходов. Таким образом, в этом случае эффективный максимальный размер документа составляет около 20 МБ.

Вы можете иметь несколько документов в конверте. Чтобы иметь несколько больших документов, создайте конверт в виде черновика, а затем загрузите дополнительные документы в виде отдельных вызовов API.

См. Документ API Limits