---
title: Обработка ошибок API
description: HTTP-коды ошибок API — значения, причины, решения
---

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

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

> **Коротко:** API возвращает HTTP-коды. Каждый код показывает, что произошло. В ответе всегда есть поле error и data с деталями.

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

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

## Коды ответов

| Код | Значение | Что делать |
|---|---|---|
| 200 OK | Успешно | Всё в порядке |
| 202 Accepted | Принято к обработке | Сообщение в очереди |
| 400 Bad Request | Неверные параметры | Проверьте тело запроса |
| 401 Unauthorized | Неверный API-ключ | Проверьте X-API-Key |
| 403 Forbidden | Нет прав | Проверьте права ключа |
| 404 Not Found | Ресурс не найден | Проверьте URL и ID |
| 429 Too Many Requests | Превышен лимит | Уменьшите частоту |
| 500 Internal Server Error | Ошибка на сервере | Обратитесь в поддержку |

## Формат ответа с ошибкой

Поля в ответе:

- error — true
- data.message — текст ошибки
- data.requestId — ID запроса для поддержки

## Что делать при разных ошибках

### 400 Bad Request

**Причина:** неверные параметры запроса.

**Решение:**
1. Проверьте формат JSON.
2. Проверьте обязательные поля.
3. Проверьте типы значений.

### 401 Unauthorized

**Причина:** неверный или отсутствующий API-ключ.

**Решение:**
1. Проверьте, что X-API-Key передан.
2. Проверьте, что ключ активен.
3. Создайте новый ключ, если старый удалён.

Подробнее: [Ошибка 401](/06-reference/03-troubleshooting/ts-auth-401-403).

### 403 Forbidden

**Причина:** у ключа нет нужного права.

**Решение:**
1. Откройте настройки ключа.
2. Добавьте нужный scope.
3. Сохраните.

### 404 Not Found

**Причина:** неверный URL или несуществующий ID.

**Решение:**
1. Проверьте базовый URL.
2. Проверьте ID ресурса.
3. Проверьте метод (GET или POST).

### 429 Too Many Requests

**Причина:** превышен лимит запросов.

**Решение:**
1. Уменьшите частоту.
2. Используйте очереди.
3. Обратитесь в поддержку, если лимит критично низкий.

Подробнее: [Ошибка 429](/06-reference/03-troubleshooting/ts-rate-limit-429).

### 500 Internal Server Error

**Причина:** ошибка на стороне сервера.

**Решение:**
1. Повторите запрос через 30 секунд.
2. Если повторяется — обратитесь в поддержку.
3. Укажите requestId в обращении.

## Как узнать requestId

В ответе с ошибкой всегда есть поле data.requestId. Сохраняйте его — это поможет поддержке быстрее найти проблему.

## См. также

- [Базовые URL](/06-reference/01-api/api-base-urls)
- [HTTP-коды ошибок](/06-reference/03-troubleshooting/ts-api-http-codes)
- [Ошибка 401 и 403](/06-reference/03-troubleshooting/ts-auth-401-403)
- [Ошибка 429](/06-reference/03-troubleshooting/ts-rate-limit-429)

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

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