API › Аккаунт

Аккаунт account

8 actions · URL: /api.php?act=<name> или /api/v1/account/<action>

account_privacy_get GET /api.php?act=account_privacy_get auth read

Настройки приватности профиля и NSFW-предпочтения текущего пользователя.

Ответ result

privacy
int — user_privacy bitmask
comments
int — user_comments bitmask
search
int — 1 = искать в поиске
invisible
int — VIP online-невидимость
saveviews
int — VIP сохранять просмотры
show_nsfw
int — показывать NSFW на главной
block_nsfw
int — блокировать NSFW-пользователей
email
string
can_delete
int
privacy_options
[{value, label}]
comments_options
[{value, label}]
rate-limit: 120 / 1 мин на user
account_privacy_set POST /api.php?act=account_privacy_set auth write csrf

Сохранить приватность и NSFW-prefs. Опущенные поля не меняются.

Параметры

имятипreqописание
privacy int нет user_privacy
comments int нет user_comments
search int нет 0|1
invisible int нет 0|1 (VIP)
saveviews int нет 0|1 (VIP)
show_nsfw int нет 0|1
block_nsfw int нет 0|1
rate-limit: 30 / 1 ч на user
account_password_change POST /api.php?act=account_password_change auth write csrf

Смена пароля (текущий + новый + повтор).

Параметры

имятипreqописание
password_old string да или current
password_new string да или password
password_new2 string да или password2

Ответ result

changed
bool

Ошибки

password_invalidСтарый неверен / новый невалиден (см. code)
rate-limit: 10 / 1 ч на user
account_email_change POST /api.php?act=account_email_change auth write csrf

Запрос смены email. Старый остаётся до подтверждения; выставляются user_captcha/user_email_verify.

Параметры

имятипreqописание
email string да новый email

Ответ result

changed
bool
verify_required
bool
email
string (текущий)
newemail
string|null

Ошибки

email_invalidEmail занят/невалиден (см. code)
rate-limit: 5 / 1 ч на user
account_captcha_submit POST /api.php?act=account_captcha_submit auth write csrf

Снять флаг user_captcha после успешной Google reCAPTCHA (как на signup).

Параметры

имятипreqописание
g-recaptcha-response string да токен reCAPTCHA v2

Ответ result

user_id
int
username
string
displayname
string
photo
string|null
email
string
verified
bool
captcha
bool (false после успеха)
need_verify
bool|omit
email_verified
bool (user_email_verify; 0 = нужно подтвердить)
mobile_verified
bool|omit

Ошибки

bad_paramsНет g-recaptcha-response
captcha_failedreCAPTCHA не пройдена
rate-limit: 20 / 1 ч на user
account_delete POST /api.php?act=account_delete auth write csrf

Soft-delete аккаунта (user_removed=time). Отзывает все bearer-токены и device tokens.

Ответ result

deleted
bool

Ошибки

forbiddenlevel_profile_delete выключен
rate-limit: 3 / 1 ч на user
account_notify_get GET /api.php?act=account_notify_get auth read

Описание не задано.

rate-limit: 120 / 1 мин на user
account_notify_set POST /api.php?act=account_notify_set auth write csrf

Описание не задано.

rate-limit: 30 / 1 мин на user