Интеграция через API

API Диадока

Подключите Контур.Диадок к собственной или нестандартной информационной системе через API. Настройте обмен электронными документами и необходимую логику работы под задачи компании.

Что такое API Диадока

API Диадока — программный интерфейс для подключения сервиса к собственной информационной системе. Разработчики могут реализовать нужную логику обмена: создавать, отправлять, получать электронные документы, подписывать их, работать со статусами и контрагентами. Такой вариант подходит для собственных и нестандартных систем, когда компании требуется индивидуальный сценарий работы.

Как работает API Диадока

HTTP API обеспечивает обмен данными между Контур.Диадоком и корпоративным ПО. Приложение компании обращается к методам через HTTP-запросы, получая ответы сервиса.

Разработчики самостоятельно определяют логику интеграции: какие операции выполнять, когда отправлять или получать данные, как обрабатывать статусы и выстраивать внутренние сценарии работы.

Возможности API Диадока

Создавать, отправлять и получать электронные документы;
Подписывать их электронной подписью;
Получать статусы обработки и отслеживать изменения;
Работать с контрагентами и приглашениями к обмену;
Согласовывать документы по заданным сценариям;
Находить нужные данные по реквизитам и другим параметрам;
Передавать результаты обработки во внутреннюю информационную систему.

HTTP API и SDK

HTTP API — базовый способ интеграции, который подходит для систем на разных языках программирования и операционных системах. Разработчики могут обращаться к его методам напрямую, самостоятельно обрабатывая запросы и ответы.

Для C# и Java доступны поддерживаемые SDK. Они упрощают разработку за счет готовых классов и методов.

Это соответствует текущей официальной документации: HTTP API остается базовым вариантом интеграции, а SDK для C# и Java продолжают обновляться и поддерживаться.

Устаревшие компоненты

С 1 сентября 2026 года Контур прекратил развитие и техническую поддержку внешней компоненты Диадок COM SDK и COM-интерфейса ComDiadocApi. Уже установленные решения продолжают работать в текущем виде, но новые функции, исправления ошибок и адаптация под изменения внешних систем для них больше не выпускаются.

Для новых интеграций рекомендуется использовать HTTP API или поддерживаемые SDK. SDK C# продолжает развиваться и поддерживаться — изменения касаются только работы через COM-интерфейс.

Как получить доступ к API Диадока

Чтобы начать разработку, зарегистрируйте интеграционное решение и получите данные для авторизации.

1. Оставьте заявку на подключение. После этого специалист предоставит доступ в Кабинет интегратора и идентификатор приложения client_id.
2. Создайте в Кабинете интегратора ключ приложения client_secret.
3. Настройте авторизацию. Для новых решений приоритетным способом является OpenID Connect.
4. Подключите интеграцию к тестовой или рабочей площадке Диадок и проверьте нужные сценарии.

Для технической настройки можно использовать официальную документацию API Диадока: в ней описаны авторизация, методы, тестовая площадка и особенности интеграции.

Для каких задач подходит API

Такой способ подходит компаниям, которым нужна собственная логика электронного документооборота и глубокая автоматизация внутренних процессов.

Решение можно использовать, если:

работа в собственной или нестандартной информационной системе;
нет подходящего готового модуля;
требуется индивидуальная обработка входящих и исходящих данных;
необходимо автоматизировать большое количество операций;
разработкой занимается внутренняя ИТ-команда или подрядчик.

Частые вопросы

Что можно автоматизировать через API Диадока?

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

Как получить доступ для разработки?

Нужно зарегистрировать решение, получить client_id, создать client_secret, затем настроить авторизацию. Перед запуском разработку можно проверить на тестовой площадке.

Какие SDK доступны разработчикам?

Для C# и Java доступны поддерживаемые SDK с готовыми классами и методами. Также разработчики могут обращаться к HTTP-интерфейсу напрямую независимо от языка программирования.

Где найти техническую документацию?

В официальной документации для разработчиков описаны методы, авторизация, тестовая площадка, форматы данных и особенности подключения.