# Ошибки и обработка ошибок
SUMMARY: HTTP-коды состояния, формат ответа с ошибкой и способы восстановления после типичных ошибок.

KEY CONTEXT:
Error format: { statusCode, error, message, docs? }
Common errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)
401 → check Mind Key/JWT, see /docs/getting-started/authentication
404 → wrong path, GET /endpoints for valid list, do NOT guess paths
429 → rate limited (?key= is 60/min), use Bearer header instead
500 → server error, retry with backoff, check /health
docs field in error response links to relevant documentation.

Ошибки и обработка ошибок
Synapse использует стандартные HTTP-коды состояния с единым форматом ответа
с ошибкой. На этой странице описано, как интерпретировать ошибки и
восстанавливаться после них.
Формат ответа с ошибкой
Все ошибки возвращают JSON следующей структуры:
[CODE BLOCK]
| Поле | Описание |
|-------|-------------|
|  | HTTP-код состояния |
|  | Имя HTTP-статуса |
|  | Человекочитаемое описание ошибки |
|  | URL соответствующей документации (если применимо) |
HTTP-коды состояния
200 OK
Успех. Запрос обработан корректно.
201 Created
Успех. Создан новый ресурс (например, ).
204 No Content
Успех. Тело ответа не возвращается (например, ).
400 Bad Request
Запрос сформирован некорректно. Типичные причины:
- Отсутствуют обязательные поля JSON
- Некорректный синтаксис JSON
- Недопустимое значение перечисления (например, неверная категория)
[CODE BLOCK]
Исправление: Проверьте тело запроса по документации API. Убедитесь, что все
обязательные поля присутствуют и содержат корректные значения.
401 Unauthorized
Ошибка аутентификации. Типичные причины:
- Отсутствует заголовок 
- Неверный Mind Key или JWT
- Используется Mind Key там, где требуется JWT (или наоборот)
[CODE BLOCK]
Исправление: Проверьте ваш токен. См. Аутентификация.
403 Forbidden
Вы аутентифицированы, но не имеете права выполнять это действие. Типичные причины:
- Попытка удалить mind другого пользователя
- Попытка подтвердить память с помощью Mind Key (требуется JWT)
- Mind отключён
Исправление: Убедитесь, что вы используете правильный тип токена для этого эндпоинта.
404 Not Found
Запрошенный путь или ресурс не существует.
> [!CRITICAL]
> Не угадывайте пути эндпоинтов. Существуют только те пути, что перечислены
> в . Если вы получили 404, значит, вы использовали неверный путь.
[CODE BLOCK]
Исправление: Вызовите , чтобы увидеть список допустимых
эндпоинтов. Сравните ваш URL со списком посимвольно.
409 Conflict
Запрос конфликтует с текущим состоянием. Типичные причины:
- Попытка зарегистрироваться с уже существующим email
- Дублирующийся URL вебхука
Исправление: Используйте другое значение или примените  для обновления
существующего ресурса.
429 Too Many Requests
Вы превысили лимит запросов. Применяется только к аутентификации через query-параметр
 (60 запросов в минуту).
[CODE BLOCK]
Заголовки ответа:
[CODE BLOCK]
Исправление: Перейдите на заголовок  (без лимита)
или подождите  секунд.
500 Internal Server Error
Ошибка сервера. Этого не должно происходить — если произошло, это баг.
Исправление:
1. Повторите запрос с экспоненциальной задержкой (1 с, 2 с, 4 с, 8 с)
2. Проверьте , чтобы убедиться, что сервер работает
3. Если ошибка повторяется, сообщите о ней
503 Service Unavailable
Сервер временно недоступен (например, во время развёртывания, миграции БД).
Исправление: Подождите и повторите запрос. Проверьте .
Паттерны восстановления
Повтор с экспоненциальной задержкой
[CODE BLOCK]
Обработка ошибок аутентификации
[CODE BLOCK]
Типовые сценарии ошибок
"Mind Key fehlt oder ungültig"
- Вы забыли заголовок 
- Вы использовали , но ключ неверный
- Вы используете JWT там, где требуется Mind Key
"Route not found"
- Вы угадали несуществующий путь
- Вы неправильно использовали HTTP-метод (например,  вместо )
- Проверьте  для списка допустимых путей
"Rate limit exceeded"
- Вы используете  и превысили лимит 60 запросов в минуту
- Перейдите на заголовок 
Следующие шаги
- Аутентификация
- Обзор API
- Лимиты запросов