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

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



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

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

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

## Симптом

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

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

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

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

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

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

```bash
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 не работает на «Мой диалог».

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

Проверьте:

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

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

1. Откройте настройки ключа в **API Подключения**.
2. Проверьте, что есть нужные scopes:

| Scope | Для чего |
|---|---|
| `omni-api` | Отправка сообщений |
| `statistics` | Просмотр статистики |
| `broadcasts` | Работа с рассылками |

3. Если scopes нет — добавьте и сохраните.

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

### 401: ключ не передан

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

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

### 401: ключ неверный

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

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

### 401: ключ от другого сервиса

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

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

### 401: ключ удалён

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

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

### 403: нет нужного scope

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

**Решение:** откройте ключ и добавьте нужный scope. [Подробнее →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-auth-401-403)

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

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

Контакты:

- **Multi API:** support@multiapi.ru

Что указать:

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

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

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

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

## См. также

<Columns cols={2}>
  <Card title="Ошибка 401 и 403" icon="lock" href="/06-reference/03-troubleshooting/ts-auth-401-403">
    Общее описание ошибок авторизации
  </Card>
  <Card title="API-ключи" icon="key" href="/06-reference/01-api/api-keys">
    Создание и управление ключами
  </Card>
  <Card title="Обзор API" icon="book" href="/06-reference/01-api/api-overview">
    Домены и базовые URL трёх сервисов
  </Card>
  <Card title="Обработка ошибок API" icon="triangle-exclamation" href="/06-reference/01-api/api-errors">
    Форматы ошибок для каждого API
  </Card>
</Columns>

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

- Multi API: support@multiapi.ru