---
title: Ошибки API: HTTP-коды
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: HTTP-коды

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

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

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

## Полный справочник кодов

| Код | Значение | Категория |
|---|---|---|
| 200 | OK | Успех |
| 202 | Accepted | Успех |
| 400 | Bad Request | Ошибка клиента |
| 401 | Unauthorized | Ошибка авторизации |
| 403 | Forbidden | Ошибка прав |
| 404 | Not Found | Ресурс не найден |
| 409 | Conflict | Конфликт данных |
| 422 | Unprocessable Entity | Невалидные данные |
| 429 | Too Many Requests | Превышен лимит |
| 500 | Internal Server Error | Ошибка сервера |
| 502 | Bad Gateway | Ошибка шлюза |
| 503 | Service Unavailable | Сервис недоступен |

## Описание и решения

### 400 Bad Request

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

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

### 401 Unauthorized

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

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

Подробнее: [Ошибка 401 и 403](/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).

### 409 Conflict

**Что значит:** конфликт данных. Например, дублирование.

**Решения:**
1. Проверьте, не создан ли уже такой ресурс.
2. Используйте уникальные идентификаторы.

### 422 Unprocessable Entity

**Что значит:** данные не прошли валидацию.

**Решения:**
1. Проверьте формат email.
2. Проверьте формат телефона.
3. Проверьте длину полей.

### 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.

### 502 Bad Gateway

**Что значит:** ошибка шлюза между сервисами.

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

### 503 Service Unavailable

**Что значит:** сервис временно недоступен.

**Решения:**
1. Подождите 1–2 минуты.
2. Повторите запрос.
3. Проверьте статус сервиса в поддержке.

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

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

## См. также

- [Обработка ошибок API](/06-reference/01-api/api-errors)
- [Ошибка 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