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

Коротко: API-ключ — ваш пропуск для интеграции с Multi API. Создаётся в личном кабинете за 1 минуту.

Кому подходит

API-ключ для отправки запросов в Multi API.

В левом меню: API Подключения.

Кнопка в правом верхнем углу.

Поле	Что указать
Название	Понятное имя, например «Тестовый ключ»
Вебхук	URL, куда будут отправляться статусы (необязательно)
Права доступа	Выберите нужные права

Право	Для чего
omni-api	Отправка сообщений, проверка статусов
statistics	Доступ к статистике и EDR
recipients	Управление получателями
broadcasts	Управление рассылками
dids	Управление DID-номерами
crm	Интеграция с CRM

Укажите, для каких имён отправителей будет действовать этот ключ.

Важно: ключ показывается только один раз. Сохраните его в надёжном месте.

Ключ передаётся в заголовке X-API-Key в каждом запросе.

Формат заголовка: X-API-Key: ваш-ключ

API-ключ создан. Вы можете использовать его для интеграции с Multi API.

Действие	Что делает
Просмотр	Показывает название, права, вебхук
Редактирование	Изменяет права, вебхук, имена отправителей
Удаление	Отзывает ключ — все запросы с ним перестанут работать

Совет: создавайте отдельный ключ для каждого окружения (тест, продакшн) и для каждого приложения.

Симптом	Причина	Решение
Ключ не показывается	Уже создан, но потерян	Создайте новый, удалите старый
401 Unauthorized	Неверный ключ	Проверьте X-API-Key
403 Forbidden	Нет нужного права	Отредактируйте ключ, добавьте право
Вебхук не работает	Неверный URL	Проверьте доступность URL