IBA Platform logo

Multi API: ошибка 401 Unauthorized

Что делать при ошибке 401 в Multi API — пошаговая проверка ключа, домена и прав доступа

Коротко: ошибка 401 означает, что API-ключ неверный, отсутствует или от другого сервиса. Решение — проверить ключ и домен.

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

  • Роль: Разработчик, Интегратор
  • Уровень: Опытный

Симптом

API Multi API возвращает 401 Unauthorized вместо ожидаемого результата.

Какой заголовок используется

API использует заголовок X-API-Key. В некоторых версиях Swagger встречается написание X-API-KEY — регистр не важен, используйте любой.

Пошаговая диагностика

1
Проверьте заголовок X-API-Key

Убедитесь, что заголовок передан в запросе:

curl --location 'https://web.multiapi.ru/api/v1/messages' \
  --header 'X-API-Key: <ваш-ключ>' \
  --header 'Content-Type: application/json'

Проверьте:

  1. Заголовок присутствует в запросе.
  2. Формат: X-API-Key: ваш-ключ.
  3. Ключ без кавычек и лишних пробелов.
2
Проверьте ключ в кабинете
  1. Откройте API Подключения в личном кабинете Multi API.
  2. Найдите ключ.
  3. Сверьте его с тем, что используется в коде.
  4. Убедитесь, что ключ не удалён.
3
Проверьте домен

Ключ от OTP-кодов не работает на Multi API. Ключ от Multi API не работает на «Мой диалог».

Ключ привязан к домену сервиса. Если вы используете ключ от OTP на домене web.multiapi.ru — вернётся 401.

Проверьте:

  • Базовый URL — web.multiapi.ru.
  • Ключ создан в личном кабинете Multi API.
  • Права ключа включают нужные scopes.
4
Проверьте права ключа
  1. Откройте настройки ключа в API Подключения.
  2. Проверьте, что есть нужные scopes:
ScopeДля чего
omni-apiОтправка сообщений
statisticsПросмотр статистики
broadcastsРабота с рассылками
  1. Если scopes нет — добавьте и сохраните.

Частые ошибки

Причина: заголовок X-API-Key отсутствует в запросе.

Решение: добавьте заголовок. Проверьте, что он передаётся в каждом запросе — некоторые HTTP-клиенты могут терять заголовки при редиректах.

Причина: ключ в коде отличается от ключа в кабинете.

Решение: сверьте символ за символом. Скопируйте ключ из кабинета заново и вставьте в код.

Причина: используется ключ от OTP-кодов или «Мой диалог».

Решение: создайте ключ в личном кабинете Multi API.

Причина: ключ был удалён в кабинете.

Решение: создайте новый ключ в разделе API Подключения.

Причина: у ключа нет права на этот метод.

Решение: откройте ключ и добавьте нужный scope. Подробнее →

Что приложить к обращению

Если после всех шагов ошибка повторяется — обратитесь в поддержку Multi API с полными данными запроса.

Контакты:

Что указать:

  • requestId из ответа — если есть.
  • Метод и URL запроса.
  • Заголовки без значения ключа — оставьте только название.
  • Время запроса.
  • Первые 4 и последние 4 символа ключа (для идентификации).

Профилактика

Следуйте этим правилам — сократите вероятность ошибок до минимума.

  1. Создавайте ключ в правильном сервисе. Multi API — ключ из Multi API.
  2. Проверяйте scopes при создании. Добавьте все нужные права сразу.
  3. Храните ключ в защищённом месте. Переменные окружения, сейфы секретов.
  4. Не удаляйте ключи без замены. Сначала убедитесь, что новый работает.
  5. Не используйте один ключ для теста и продакшена. Разные окружения — разные ключи.

См. также

Ошибка 401 и 403

Общее описание ошибок авторизации

API-ключи

Создание и управление ключами

Обзор API

Домены и базовые URL трёх сервисов

Обработка ошибок API

Форматы ошибок для каждого API

Нужна помощь?