Интеграция с API

Этот раздел описывает порядок действий, которые нужно выполнить для интеграции с Диадоком через HTTP API.

Адреса точек входа в API Диадока:

• https://diadoc-api.kontur.ru — главная площадка

• https://diadoc-api-staging.kontur.ru — тестовая площадка

Получение доступа к API

Чтобы начать работать с Диадоком через HTTP API, нужно зарегистрировать интеграционное решение и получить данные для авторизации. Для этого:

1. Оставьте заявку на странице интеграции. После этого с вами свяжется менеджер, предоставит доступ в Кабинет интегратора и выдаст идентификатор вашего приложения client_id.

2. Выпустите в Кабинете интегратора ключ приложения client_secret по инструкции. Это секретный ключ, не передавайте его третьим лицам.

3. Выберите подходящий для вашего приложения алгоритм аутентификации по схеме ниже:

   

   Затем:

   • укажите выбранный алгоритм в Кабинете интегратора в настройке приложения «Способ получения токенов»,

   • реализуйте выбранный алгоритм в вашем приложении согласно инструкции:

     • Получение токена через Authorization Code Flow

     • Получение токена через Device Authorization Flow

4. Получите с помощью выбранного алгоритма токен доступа access_token и используйте его в заголовке Authorization при вызовах методов API Диадока:

   Authorization: Bearer <access_token>
   

   Пример вызова метода

   GET /GetMyOrganizations
   Host: diadoc-api.kontur.ru
   Authorization: Bearer {{access_token}}
   Accept: application/json
   

   Обратите внимание, что время жизни токена ограничено: токен нужно обновить пока он еще активен.

Разработка интеграционного решения

После получения доступа к API:

• Ознакомьтесь с порядком передачи данных в API Диадока и выберите удобный формат данных для вашего интеграционного решения.

• Постройте свое интеграционное решение, руководствуясь инструкциями. Чтобы проверить работоспособность API в вашем интеграционном решении, вы можете воспользоваться примером со страницы Быстрый старт.

Вам может быть полезна следующая информация:

• Политика устаревания — информация о порядке устаревания методов и структур API;

• Технические особенности — информация об особенностях и ограничения API Диадока и о способах передачи данных;

• Авторизация — схема авторизации в API Диадока;

• Инструкции — инструкции по работе с API;

• Порядок документооборота — описание принципов документооборота документов в Диадоке;

• Глоссарий — информация о сущностях Диадока и интерфейсах для работы с ними;

• Документация в спецификации OpenAPI — машиночитаемое описание API для автоматизации интеграции и тестирования.

Обратите внимание, что для упрощения взаимодействия с API вы можете воспользоваться SDK с примерами.

Если у вас возникли проблемы, сообщите нам.