2013-10-25 3 views
0

DocuSign настоятельно рекомендует использовать REST API вместо SOAP, и они сильно зависят от этого в вашей первоначальной реализации. Они даже предполагают, что новые функции могут в один прекрасный день only be implemented in REST, что является моей главной заботой. Я склоняюсь к использованию их SOAP API в любом случае для нашей интеграции, и мой основной вопрос заключается в следующем:Любая причина, по которой я не могу использовать обе версии REST и SOAP DocuSign API вместе?

Предположим, что будущий сценарий я боюсь - я построю свой уровень интеграции DocuSign в SOAP API. В следующем году DocuSign действительно оставляет модель SOAP позади, выпускает новые функции только для REST API, и мне отчаянно нужно использовать одну из этих функций. Есть ли какая-то причина, по которой я не могу просто оставить всю мою интеграцию SOAP на месте и реализовать интеграцию с новой функцией с помощью REST API? Я понимаю, что ссылки на оба API немного раздуют размер моего развертывания, но я могу принять этот риск. Кроме этого, есть ли какая-то веская причина, по которой я не могу использовать оба бок о бок? Разве это что-то сломает?

ответ

2

В вашей интеграции вполне приемлемо использовать сочетание API-интерфейса DocuSign SOAP API и REST API. На самом деле, это очень распространенный сценарий по конкретной причине, о которой вы говорите - некоторые функции реализованы только в SOAP или только в REST, поэтому часто необходимо использовать смешанный подход, чтобы получить полную функциональность, которая вам нужна.

+0

Их документация, похоже, говорит, что на сегодняшний день все реализовано в обоих API. Можете ли вы указать мне на функции, которые реализованы только в том или ином виде. Если в наборе функций уже есть расхождение, мне нужно учитывать эти различия с самого начала. –

+0

Слишком много различий для перечисления здесь. Несколько примеров: операция SOAP PurgeDocuments и операция SOA ExportAuthoritativeCopy в настоящее время не имеют эквивалентов REST API. Вместо того, чтобы пытаться сравнивать/сопоставлять весь API SOAP со всем API REST, я бы посоветовал начать с определения, какие операции вам понадобятся для вашей интеграции, а затем определить 1x1, какая из этих операций существует в REST и какие существуют в SOAP. Это позволит вам принять наилучшее решение для вашего конкретного случая. –

+0

Приложение 1 руководства API REST (http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf) показывает эквивалент API SOAP для каждого метода API REST. (Но заметьте - этот список показывает только UNION из двух API, он НЕ показывает никаких различий.) –

Смежные вопросы