Варианты интеграции¶
В зависимости от ваших задач, требований к клиентской части и доступных средств разработки вы можете выбрать один из нижеперечисленных способов интеграции с API Диадока.
HTTP API¶
HTTP API — базовый уровень интеграции. Преимущество этого способа интеграции в том, что на уровне HTTP API можно построить платформо-независимые решения. Это значит, что с HTTP API могут работать клиентские приложения, которые написаны на разных языках программирования и запускаются под разными операционными системами.
Но этот способ имеет свой недостаток: все сложности взаимодействия клиентской части с API через HTTP разработчик должен взять на себя.
Эта документация описывает работу именно с HTTP API: его подходы, инструменты и методы.
Чтобы интегрироваться с Диадоком с помощью HTTP API, следуйте инструкции.
Готовые интеграционные решения¶
Чтобы облегчить сложности взаимодействия клиентской части с HTTP API, разработаны готовые решения, которые разработчики могут использовать в своих приложениях. То есть клиентские приложения могут обращаться напрямую к HTTP API Диадока, а могут использовать одно из готовых решений:
Диадок.Коннектор — облачное решение, которое интегрирует Диадок с учетной системой. Подойдет компаниям со сложными бизнес-процессами и большим объемом документооборота.
SDK Диадока — набор готовых инструментов для разработки клиентских приложений. Включает в себя решения на языках:
Для интеграторов, ведущих разработку в стеке технологий Microsoft, доступна клиентская библиотека .NET/COM.
1С модуль — решает задачи стыковки 1С-решений с Диадоком.
Внешняя компонента — библиотека для интеграции учётных систем с Диадоком через COM-интерфейс. Написана на языке C++ и не содержит лишних зависимостей, поэтому работает на любой Windows-системе без установки дополнительных модулей. Компонента может загружаться как внешняя компонента по технологии 1С или как классический COM-объект.
SAP модуль — комплекс Контур-ERP для SAP. Обеспечивает бесшовную интеграцию SAP ERP с Диадоком.
Библиотека .NET/COM¶
Для клиентов, которые используют технологии Microsoft, в SDK Диадока существует библиотека DiadocApi.dll. Она является надстройкой над HTTP API и преобразует обращения к объектам и методам в HTTP-команды API Диадока.
Библиотека заключает в себе работу с криптографией, так что разработчикам клиентского приложения не придется разбираться в CryptoAPI. Кроме этого она позволяет работать с Диадоком через прокси-сервер.
Точкой входа в библиотеку является объект DiadocApi. Методы этого объекта — обертки над HTTP-командами API Диадока.
Объект ComDiadocApi — обертка объекта DiadocApi, которая предназначена для обращений через инфраструктуру COM.
Библиотека написана на платформе .NET Framework на языке C#. В составе SDK есть примеры использования библиотеки.