API › Ошибки

Ошибки

В случае ошибки сервер возвращает HTTP-статус 200 OK и тело JSON:

{ "ok": false, "error": "code_string", "extra_field": "..." }

Поле error — машинно-читаемый код (snake_case). Дополнительные поля зависят от ошибки (например, code для login_failed с внутренним кодом se_user).

Общие коды

код	смысл
`unknown_act`	act не найден в карте.
`handler_missing`	Файл хендлера отсутствует.
`handler_not_implemented`	Функция api_handle_<act> не определена.
`bad_params`	Не хватает обязательных полей.
`auth_required`	Действие требует логина (cookie или Bearer).
`csrf_invalid`	CSRF-токен отсутствует/не совпадает (только cookie-auth).
`method_not_allowed`	Write-action вызван не через POST.
`rate_limited`	Лимит запросов превышен; смотри заголовок Retry-After.
`login_failed`	Неверный email/пароль или аккаунт отключён.
`too_many_attempts`	Слишком много неудачных логинов в сессии.
`already_logged_in`	Попытка signup/token_issue из уже залогиненной сессии.
`tos_required`	Не отмечено согласие с условиями.
`invite_required`	Не передан invite_code, хотя обязателен.
`invite_invalid`	Invite-код не найден или не подходит к email.
`captcha_failed`	Не пройдена reCAPTCHA.
`token_issue_failed`	Логин прошёл, но не удалось получить токен.
`empty_response`	Хендлер не вызвал api_ok/api_err (баг сервера).

Action-специфические коды

код	actions	смысл
`group_post_create_failed`	`group_post_create`	Не удалось вставить тему.
`voice_not_found`	`group_post_create`	Голосовая запись не найдена или не принадлежит пользователю.
`circle_not_found`	`group_post_create`	Кружок не найден или не принадлежит пользователю.
`verification_required`	`friend_add`	Аккаунт не верифицирован (email/телефон).
`already_friends`	`friend_add`	Уже друзья.
`request_already_sent`	`friend_add`	Заявка уже отправлена.
`blocked`	`friend_add`	Пользователь добавил вас в чёрный список.

HTTP-заголовки

Retry-After

Возвращается вместе с rate_limited. Значение в секундах — когда повторить попытку.