В случае утери пароля пользователь может инициировать процедуру его восстановления. На сервере ЛитРес пароли не хранятся в открытом виде, поэтому восстановление фактически означает генерацию нового пароля и его отправку на пользовательский 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 } }