Главная / Документация / СистемаИнтеграцииAPI-ключи для внешних систем: права, срок действия, разовый показ секрета, отзыв и статистика использования.Обновлено 05.07.2026Интеграции дают внешним системам (например 1С или шине данных) доступ к API volrix.pm без человеческой учетной записи. Доступ выдается API-ключами: у каждого свое имя, набор прав и срок жизни; ключ можно мгновенно отозвать, не трогая остальные.Создание ключа

Задайте имя и права Название (например «Интеграция с 1С») и набор прав - какие операции ключу разрешены. Права выражаются в тех же терминах «модуль.действие», что и роли: например projects:read, tasks:update.

Задайте срок Срок действия - до даты или бессрочно.

Сохраните секрет Полное значение ключа показывается один раз при создании - скопируйте его сразу. Дальше в списке виден только короткий префикс.

Передайте интеграции Внешняя система шлет ключ в заголовке X-Api-Key при каждом запросе.

Жизнь ключа

**Статусы** - активен, истекает, истек, отозван (видно в списке).

**Использование** - статистика вызовов по дням: жива ли интеграция и как интенсивно работает.

**Отзыв** - мгновенно блокирует ключ; используйте при компрометации или выводе интеграции. Отозванный ключ остается в системе для истории.

Принцип минимума: выдавайте ключу только нужные права и конечный срок. Один ключ - одна интеграция, тогда отзыв не заденет соседей. Потерянный секрет не восстановить - отзовите ключ и выпустите новый.Документация APIЕсли в установке включена публикация документации API, полный интерактивный справочник методов доступен по адресу /api/docs. В закрытых контурах его обычно держат выключенным наружу. Структура API описана в ветке Инструкции разработчика.Кто видит разделДоступ дают права integrations.read (просмотр) и integrations.manage (выпуск и отзыв) - по умолчанию у администратора системы (см. Роли и доступы).Соответствует версии продукта 0.9.0. Дата проверки: 2026-06-24.

Интеграции и REST API

Функциональная карта