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

Управление ключами находится в разделе Компания → API-ключи и доступно пользователям с правом доступа к этому разделу. Отдельные ключи позволяют разграничивать права разных интеграций.

Описание методов, параметров запросов и ответов находится в документации API 2.0Переход на внешний сайтhttps://api.macroserver.ru/docs/api/v2/. Для подключения ИИ-клиентов используйте MCP API v2: в этой статье описаны настройка подключения, общий доступ по токену и индивидуальный доступ сотрудников через OAuth.

#Как создать API-ключ

1. Откройте Компания → API-ключи.
2. Нажмите Добавить API-ключ.
3. Укажите «Название API-ключа» и нажмите Создать. Откроется страница созданного ключа. По названию ключа можно отслеживать деятельность приложения в логах сущностей.
4. В разделе «Управление доступами к действиям» выберите действия, необходимые приложению.
5. Нажмите Сохранить.

Каждый API-ключ имеет собственные настройки доступа. Для разных внешних приложений можно создать отдельные ключи.

#Как передать реквизиты подключения

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

В индивидуальном режиме общий токен скрыт: сотрудники подключаются через OAuth. Порядок назначения сотрудников и подключения описан в MCP API v2.

#Как заменить токен

Если токен общего доступа скомпрометирован, нажмите Обновить на странице API-ключа. Приложения со старым токеном сразу потеряют доступ. Передайте новые реквизиты и замените токен в подключённых приложениях.