> ## Documentation Index
> Fetch the complete documentation index at: https://api.zenedu.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ошибки

> Коды ошибок и их обработка в Zenedu API

## HTTP-коды ответа

| Код | Описание |
| - | - |
| `200` | Успешно |
| `201` | Ресурс создан |
| `204` | Успешно, без содержимого |
| `401` | Не авторизован — токен неверный или не передан |
| `403` | Доступ запрещён — нет прав или нужна подписка Pro |
| `404` | Не найдено — ресурса не существует |
| `413` | Слишком большой запрос — файл превышает лимит размера |
| `422` | Ошибка валидации — подробности в поле `errors` |
| `429` | Превышен лимит запросов — смотрите заголовок `Retry-After` |
| `502` | Ошибка шлюза — сбой внешнего сервиса (Telegram) |

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

```json theme={null}
{
  "message": "The given data was invalid.",
  "errors": {
    "field_name": [
      "The field_name is required."
    ]
  }
}
```

Тексты ошибок в ответах API всегда на английском.

## Лимит запросов

Количество запросов к API ограничено. При превышении лимита API возвращает код `429` и заголовок `Retry-After` — через сколько секунд можно повторить запрос.

## Ошибки Telegram

При отправке сообщений через API Telegram может вернуть ошибки:

| Код | Значение |
| - | - |
| `422` | Подписчик заблокировал бота или неактивен |
| `429` | Лимит Telegram — соблюдайте заголовок `Retry-After` |
| `502` | Ошибка авторизации в Telegram или сбой доставки сообщения |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.