API › Пользователи

Пользователи user

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

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

Профиль пользователя по id или username. Включает флаги отношений с текущим юзером.

Параметры

имятипreqописание
id int id или username
username string id или username

Ответ result

user_id
int
username
string
displayname
string
photo
string
user_status
string — статус/подпись (пусто если private)
status_date
int
friends_total
int
private
bool — профиль закрыт для зрителя
is_friend
bool
request_outgoing
bool — я отправил заявку
request_incoming
bool — он отправил мне заявку
is_subscribed
bool — подписан ли я на его блог
userpoints
int — только для self; баланс баллов
rate-limit: 120 / 1 мин на user
user_update POST /api.php?act=user_update auth write csrf

Обновить displayname / fname / lname / status (статус как misc_js status_change).

Параметры

имятипreqописание
displayname string нет
fname string нет
lname string нет
status string нет макс. 100
rate-limit: 30 / 1 мин на user
user_photo_upload POST /api.php?act=user_photo_upload auth write csrf

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

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

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

rate-limit: 30 / 1 мин на user
profile_fields_get GET /api.php?act=profile_fields_get auth read

Поля профиля (se_profilevalues / se_profilefields). edit=1 — форма для владельца с options.

Параметры

имятипreqописание
user_id int нет по умолч. — self
edit int нет 1 — форма редактирования (только self)

Ответ result

cats
[{cat_id, title, fields:[{field_id,type,title,value,display_value,options,…}]}]
rate-limit: 120 / 1 мин на user
profile_fields_set POST /api.php?act=profile_fields_set auth write csrf

Сохранить поля профиля (self). fields — JSON object field_id→value.

Параметры

имятипreqописание
fields string да JSON object

Ответ result

updated
bool
rate-limit: 30 / 1 мин на user
profile_comments_list GET /api.php?act=profile_comments_list auth read

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

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

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

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

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

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

Редактировать свой комментарий на стене.

Параметры

имятипreqописание
user_id int да
comment_id int да
body string да HTML
rate-limit: 30 / 1 мин на user