---
title: Multi API: ошибка 401 Unauthorized
description: Что делать при ошибке 401 в Multi API — проверка ключа и прав
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

# Multi API: ошибка 401 Unauthorized

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

## Симптом

API Multi API возвращает 401 Unauthorized.

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

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

1. Проверьте, что заголовок передан в запросе.
2. Проверьте формат: X-API-Key: ваш-ключ.
3. Проверьте, что ключ без кавычек и пробелов.

### Шаг 2. Проверьте ключ в кабинете

1. Откройте **API Подключения**.
2. Найдите ключ.
3. Сверьте ключ с тем, что используется в коде.
4. Убедитесь, что ключ не удалён.

### Шаг 3. Проверьте домен

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

Проверьте:

- Базовый URL — web.multiapi.ru.
- Ключ создан в личном кабинете Multi API.
- Права ключа включают нужные scopes.

### Шаг 4. Проверьте права ключа

1. Откройте настройки ключа.
2. Проверьте, что есть нужные scopes:
   - omni-api — для отправки.
   - statistics — для статистики.
3. Если scopes нет — добавьте.

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

| Ошибка | Причина | Решение |
|---|---|---|
| 401 Unauthorized | Ключ не передан | Добавьте заголовок |
| 401 Unauthorized | Ключ неверный | Сверьте с кабинетом |
| 401 Unauthorized | Ключ от другого сервиса | Создайте ключ в Multi API |
| 401 Unauthorized | Ключ удалён | Создайте новый |
| 403 Forbidden | Нет нужного scope | Добавьте scope |

## Что делать, если не помогает

Обратитесь в поддержку **support@multiapi.ru**.

Укажите:

- requestId из ответа.
- Метод и URL запроса.
- Заголовки без ключа.
- Время запроса.
- Первые 4 и последние 4 символа ключа.

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

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

## См. также

- [Ошибка 401 и 403](/06-reference/03-troubleshooting/ts-auth-401-403)
- [API-ключи](/06-reference/01-api/api-keys)
- [Базовые URL](/06-reference/01-api/api-base-urls)
- [Обработка ошибок API](/06-reference/01-api/api-errors)

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

- Multi API: support@multiapi.ru