Multi API: ошибка 401 Unauthorized
Что делать при ошибке 401 в Multi API — проверка ключа и прав
Multi API: ошибка 401 Unauthorized
Коротко: ошибка 401 означает, что API-ключ неверный, отсутствует или от другого сервиса. Решение — проверить ключ и домен.
Симптом
API Multi API возвращает 401 Unauthorized.
Пошаговая диагностика
Шаг 1. Проверьте заголовок X-API-Key
- Проверьте, что заголовок передан в запросе.
- Проверьте формат: X-API-Key: ваш-ключ.
- Проверьте, что ключ без кавычек и пробелов.
Шаг 2. Проверьте ключ в кабинете
- Откройте API Подключения.
- Найдите ключ.
- Сверьте ключ с тем, что используется в коде.
- Убедитесь, что ключ не удалён.
Шаг 3. Проверьте домен
Важно: ключ от OTP-кодов не работает на Multi API. Ключ от Multi API не работает на «Мой диалог».
Проверьте:
- Базовый URL — web.multiapi.ru.
- Ключ создан в личном кабинете Multi API.
- Права ключа включают нужные scopes.
Шаг 4. Проверьте права ключа
- Откройте настройки ключа.
- Проверьте, что есть нужные scopes:
- omni-api — для отправки.
- statistics — для статистики.
- Если scopes нет — добавьте.
Частые ошибки
| Ошибка | Причина | Решение |
|---|---|---|
| 401 Unauthorized | Ключ не передан | Добавьте заголовок |
| 401 Unauthorized | Ключ неверный | Сверьте с кабинетом |
| 401 Unauthorized | Ключ от другого сервиса | Создайте ключ в Multi API |
| 401 Unauthorized | Ключ удалён | Создайте новый |
| 403 Forbidden | Нет нужного scope | Добавьте scope |
Что делать, если не помогает
Обратитесь в поддержку support@multiapi.ru.
Укажите:
- requestId из ответа.
- Метод и URL запроса.
- Заголовки без ключа.
- Время запроса.
- Первые 4 и последние 4 символа ключа.
Профилактика
- Создавайте ключ в правильном сервисе.
- Проверяйте scopes при создании.
- Храните ключ в защищённом месте.
- Не удаляйте ключи без замены.
- Не используйте один ключ для теста и продакшена.
См. также
Нужна помощь?
- Multi API: support@multiapi.ru