Запрос во многом аналогичен запросу на регистрацию, но позволяет изменить данные в профиле пользователя. Однако обратите внимание на дополнительное поле cur_pwd.
Параметры, имена которых не переданы, не изменяются. Параметры, которые переданы с явным значением «null», назначаются пустыми. Благодаря этому данный запрос является расширяемым, при этом старые приложения не будут затирать неизвестные им данные.
При изменении логина, e-mail'а или пароля обязательно требуется передавать пару логин/текущий пароль.
ID функции
w_update_user_data
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
cur_pwd – текущий пароль пользователя. Требуется передавать его, если вы меняете логин, пароль или e-mail пользователя. В остальных случаях параметр можно не передавать;
mail – e-mail пользователя. Параметр не может быть удален если не указан login;
login – логин. Минимальная длина 5 символов. Параметр не может быть удален если не указан mail;
pwd – новый пароль. Минимальная длина 5 символов. Если этот параметр не передан – пароль не меняется;
first_name – имя;
middle_name – отчество;
last_name – фамилия;
nickname – видимое другим людям имя пользователя;
phone – номер телефона;
birth_date – дата рождения в ISO-виде, например, «1999-12-21»;
gender – пол, может принимать значения: m – мужчина, f – женщина;
no_mail – запрет на отправку e-mail уведомления с просьбой подтвердить адрес при смене e-mail:
- 0 – welcome-уведомления разрешены;
- 1 – welcome-уведомления запрещены;
profile_privacy – доступность профиля пользователя, может принимать значения:
- closed – закрытый профиль;
- public – открытый профиль;
descr – описание пользователя. Текст длиной не более 256 символов.
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101006 | Запрошенный логин уже занят. | В запросе передан login, уже занятый другой учетной записью. |
101009 | E-mail некорректен. | Параметр mail имеет некорректный формат. |
101010 | E-mail уже принадлежит другому пользователю. | В запросе передан mail, уже занятый другой учетной записью. |
101011 | Некорректный номер телефона. | Параметр phone имеет некорректный формат. |
101012 | Телефон уже принадлежит другому пользователю. | В запросе передан phone, уже занятый другой учетной записью. |
101013 | Неверное сочетание логина/пароля. | В запросе передана некорректная комбинация login/pwd (или login/cur_pwd). |
101014 | Слишком много ошибок авторизации, доступ временно заблокирован. | При последнем запросе был превышен лимит ошибочных попыток авторизации с указанием неверных сочетаний login/pwd (или login/cur_pwd). Попробуйте повторить запрос через некоторое время. |
101015 | Пароль некорректен. | Параметр pwd (с новым паролем) имеет длину менее 5 символов. Укажите более длинный пароль. |
101019 | Логин некорректен. | Параметр login имеет длину менее 5 символов. |
101150 | Неверное заполнение поля доступности профиля. | Поле profile_privacy должно иметь значения «closed» или «public». |
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [
{
"func": "w_update_user_data",
"id": "Ive_changed_my_email",
"param": {
"mail": "new@mail.ru"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"Ive_changed_my_email": {
"success": true
}
}