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