---
title: Ошибки авторизации 401 и 403
description: Что делать при ошибках 401 Unauthorized и 403 Forbidden в API IBA Platform — проверка ключа, домена, прав доступа
---

> **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-ключ. Ошибка 403 — у ключа нет нужного права. Решения разные.

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

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

## Симптом

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

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

<Note>
API использует заголовок `X-API-Key` (иногда в документации встречается написание `X-API-KEY`). Регистр не важен — используйте любой из них.
</Note>

<Note>
Исключение — **2FA-эндпоинты**. Они используют не `X-API-Key`, а **Basic Auth**. Логин — API-ключ интеграции, пароль — пустой.
</Note>

## Диагностика и решения

### 401 Unauthorized

### Что значит

Ключ не передан, неверный, удалён или от другого сервиса.

### Причины

| Причина | Как проверить |
|---|---|
| API-ключ не передан | Проверьте заголовки запроса |
| Ключ неверный | Сверьте с ключом в кабинете |
| Ключ удалён | Проверьте список ключей |
| Ключ от другого сервиса | Проверьте, для какого сервиса создан |

### Решения

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

Он должен быть в каждом запросе. Значение — ваш ключ без кавычек.

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

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

Откройте **API Подключения** и сверьте ключ с тем, что в вашем коде.

#### 3. Проверьте, что ключ активен

Удалённые ключи не работают. Если ключ удалён — создайте новый.

#### 4. Проверьте домен

Ключ от OTP не работает на Multi API. Ключ от Multi API не работает на «Мой диалог». Убедитесь, что используете ключ из нужного сервиса.

<Warning>
Если ключ был скомпрометирован — немедленно удалите его и создайте новый. Старый ключ может быть использован злоумышленниками.
</Warning>

### 403 Forbidden

### Что значит

У ключа нет нужного права (scope) для этого метода.

### Причины

| Причина | Как проверить |
|---|---|
| Нет нужного scope | Проверьте права ключа |
| Scope не активирован | Проверьте список прав |
| Доступ ограничен | Проверьте настройки ключа |

### Решения

#### 1. Откройте настройки ключа

Раздел **API Подключения** → выберите ключ → **Редактировать**.

#### 2. Добавьте нужный scope

| Scope | Для чего |
|---|---|
| `omni-api` | Отправка сообщений через OMNI API |
| `statistics` | Просмотр статистики |
| `recipients` | Работа с получателями |
| `broadcasts` | Работа с рассылками |
| `dids` | Работа с номерами |
| `crm` | Интеграция с CRM |

#### 3. Сохраните ключ

После сохранения изменения вступают в силу сразу. При необходимости перезапустите запросы.

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

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

Контакты:

- **OTP-коды:** support@otpcod.ru
- **Multi API:** support@multiapi.ru
- **Мой диалог:** support@mydialogi.ru

Что указать:

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

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

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

1. **Создавайте отдельный ключ для каждого окружения.** Тест и продакшен — разные ключи.
2. **Проверяйте scope при создании ключа.** Легко забыть добавить нужное право.
3. **Не удаляйте ключи без замены.** Убедитесь, что новый ключ работает, прежде чем удалять старый.
4. **Храните ключи в защищённом месте.** Переменные окружения, сейфы секретов. Не коммитьте в Git.
5. **Ротируйте ключи.** Раз в 3–6 месяцев создавайте новые и удаляйте старые.

## См. также

<Columns cols={2}>
  <Card title="API-ключи" icon="key" href="/06-reference/01-api/api-keys">
    Создание и управление ключами доступа
  </Card>
  <Card title="Обработка ошибок API" icon="triangle-exclamation" href="/06-reference/01-api/api-errors">
    Форматы ошибок для каждого API
  </Card>
  <Card title="HTTP-коды ошибок" icon="code" href="/06-reference/03-troubleshooting/ts-api-http-codes">
    Полный справочник кодов ответа
  </Card>
  <Card title="Multi API: ошибка 401" icon="plug" href="/06-reference/03-troubleshooting/ts-mapi-401">
    Частный случай для Multi API
  </Card>
</Columns>

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

- OTP-коды: support@otpcod.ru
- Multi API: support@multiapi.ru
- Мой диалог: support@mydialogi.ru