2013-10-25 94 views
0

DocuSign強烈建議使用REST API而不是SOAP,並且他們會在初次實施時大力推薦。他們甚至建議有一天可能會有新功能only be implemented in REST,這是我最關心的問題。我傾向於使用他們的SOAP API進行集成,我的主要問題是:爲什麼我不能同時使用DocuSign API的REST和SOAP版本?

讓我們假設我擔心的未來情景 - 我在SOAP API上構建DocuSign集成層。明年,DocuSign事實上將SOAP模型留下,僅在REST API上發佈新功能,而我迫切需要使用這些功能之一。是否有任何理由不能簡單地保留我的所有SOAP集成,並使用REST API實現與新功能的集成?我明白,引用這兩個API會使我的部署規模膨脹一點,但我可以接受這種風險。除此之外,是否有任何令人信服的理由,我不能並排使用?它會破壞什麼?

回答

2

在集成中使用DocuSign SOAP API和REST API的組合是完全可以接受的。事實上,由於您提到的確切原因,這是非常常見的情況 - 某些功能僅在SOAP中實現,或者僅在REST中實現,因此通常需要使用混合方法才能獲得所需的全部功能。

+0

他們的文檔似乎在說,迄今爲止,所有內容都在兩個API中實現。你能指出我只能在其中一箇中實現的功能嗎?如果特徵集中已經存在分歧,我需要從一開始就考慮這些區分。 –

+0

這裏列舉的差異太多了。但是有一些例子 - SOAP PurgeDocuments操作和SOAP ExportAuthoritativeCopy操作目前沒有REST API等價物。我不建議將整個SOAP API與整個REST API進行比較/對比,而是建議您首先確定集成需要哪些操作,然後確定1x1哪些操作存在於REST中,哪些存在在SOAP中。這將使您可以針對您的特定情況做出最佳決定。 –

+0

REST API指南(http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf)的附錄1顯示了每種REST API方法的等效SOAP API。 (但請注意 - 此列表僅顯示兩個API的UNION;它不顯示任何差異。) –

相關問題