API-ключи

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

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

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

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

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

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

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

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

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

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

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

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

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