最佳做法-调用API或调用C#客户端库

时间:2019-06-28 18:11:42

标签: docusignapi

我们正在将新系统与DocuSign集成在一起。该系统使用C#对象构建。

我的问题是,与DocuSign交互的最佳实践是-直接调用DocuSign Web API方法,或者将DocuSign C#客户端库作为对我们代码的引用,然后直接调用它?

谢谢!

2 个答案:

答案 0 :(得分:1)

我建议使用C#客户端库。这将节省您的时间,并使其非常易于使用。 它的代码在github中也是公开的,因此,如果出于某种原因您想要分叉并以这种方式使用它,您也可以这样做。

答案 1 :(得分:0)

DocuSign C#SDK避免了以下麻烦:

  • 将请求对象序列化为JSON结构
  • 发送HTTPS请求
  • 将响应对象反序列化为C#对象。

它还包括用于实现OAuth JWT授权流程的帮助程序方法。

这些都是使用SDK的充分理由。

如果您希望定期发送大小超过20MB的文档,则您可能需要自己实施Envelopes :: create调用。为什么?因为当前版本的SDK BASE64会对您上传到DocuSign的文档进行编码。

如果您自己实现Envelopes :: create调用,则可以二进制格式发送文档。这并不是一件容易的事,但是如果您有非常大的源文档,那么这很重要。 An example of how to send in binary mode.

已添加

大小限制:每个API调用25MB。但是API调用中经过BASE64编码的文档有很多开销。因此,在这种情况下,有效的最大文档大小约为20 MB。

您可以在信封中放入多个文档。要拥有多个大型文档,请创建信封作为草稿,然后将其他文档作为单独的API调用上传。

请参见API Limits document