В случае утери пароля пользователь может инициировать процедуру его восстановления. На сервере ЛитРес пароли не хранятся в открытом виде, поэтому восстановление фактически означает генерацию нового пароля и его отправку на пользовательский e-mail. И если к пользовательскому аккаунту не был привязан почтовый ящик, то восстановление пароля через приведенный далее запрос невозможно.
Запрос инициирует посылку пользователю первого письма, общий смысл которого сводится к «кто-то запросил восстановление пароля на вашем аккаунте в «ЛитРес», кликните сюда, чтобы создать новый пароль». В случае если пользователь, следуя инструкциям в письме, подтверждает свое желание сгенерировать новый пароль, пароль для него будет создан и отправлен на e-mail (второе письмо).
Обобщая сказанное, автору клиента следует исходить из того, что первое письмо о восстановлении пароля будет содержать требование открыть некий URL, после чего пользователь получит следующее письмо, с новым рабочим паролем. Старый пароль восстановлению не подлежит.
ID функции
w_recover_pass
Кто может вызывать
Любой пользователь
Авторизованное приложение
Принимаемые параметры
mail* – e-mail, который пользователь указал при регистрации или иным образом.
Возвращаемые значения
Нет
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101040 | Указанный e-mail не зарегистрирован в системе | Указанный e-mail не зарегистрирован ни у одного пользователя. Инициация смены пароля не произведена. |
101041 | Некорректный формат e-mail | Отсутствует параметр mail или его значение не соответствует формату электронной почты. |
101052 | Другие ошибки | При восстановлении пароля произошли необработанные ошибки. Обратитесь к разработчику. |
Пример запроса на сервер
{
"sid": "f121e02084344f06da1a5213999e8fcG",
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"requests": [
{
"func": "w_recover_pass",
"id": "recover_pass",
"param": {
"mail": "my@mail.com"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"recover_pass": {
"success": true
}
}