Если у пользователя имеется несколько аккаунтов на ЛитРес, то их можно объединить. При этом все остатки на счетах и купленные книги суммируются и остаются на том аккаунте, от имени которого инициируется объединение. Второй же аккаунт, присоединяемый к текущему, полностью удаляется. Функция может оказаться особенно полезной в следующем сценарии: приложение при первом запуске автоматически регистрирует пользователя, создавая ему случайный логин/пароль («авторег») и позволяя пользователю пользоваться магазином без дополнительных усилий по регистрации.
В какой-то момент пользователь вспоминает, что у него уже есть учетная запись на ЛитРес и у него возникает потребность получить доступ ко всему принадлежащему ему контенту. В этот момент можно объединить аккаунты, в том числе «прозрачно» для пользователя, и он, просто введя уже существующие e-mail/пароль, получит вместо ошибки «такая учетная запись уже существует, переименование невозможно» нормально работающий объединенный аккаунт.
Примечание: SID в запросе требуется передавать от текущей (основной) учётной записи пользователя, а не от присоединяемой.
ID функции
w_unite_user
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
sid* – SID от текущей (основной) учётной записи пользователя;
login_mail* – логин или e-mail от присоединяемой (уничтожаемой) учётной записи;
pwd* – пароль от присоединяемой (уничтожаемой) учётной записи.
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101025 | Неверное сочетание логина/e-mail и пароля | В запросе передана некорректная комбинация login_mail/pwd |
101026 | Слишком много ошибок объединения аккаунтов, доступ временно заблокирован | При последнем запросе был превышен лимит ошибочных попыток объединения аккаунтов с указанием неверных сочетаний login_mail/pwd. Попробуйте повторить запрос через 3 минуты |
101058 | Основная учетная запись совпадает с присоединяемой | Логин или e-mail (login_mail) от присоединяемой учётной записи совпадает с логином текущего авторизованного пользователя |
101059 | Объединять учетную запись библиотекаря нельзя | Учетные записи с правами Библиотекаря (в проекте «Библиотека: ЛитРес») не имеют возможности объединения. Используйте другие учетные записи для объединения |
101100 | Нельзя объединять учетную запись пользователя школьной библиотеки | Учетные записи пользователей проекта «ЛитРес: Школа» не имеют возможности объединения |
101178 | Same library users merge forbidden | Нельзя объединять учетные записи пользователей одной библиотеки |
101186 | More than one phone | У пользователей разные номера телефонов |
101187 | You cannot unite RTK subscribers | Невозможно объединение пользователей, у которых имеется подписка «Ростелеком» |
Пример запроса на сервер
{ "sid": " ", "app": "1", "time": "2019-12-26T13:07:50+03:00", "sha": " ", "requests": [ { "func": "w_unite_user", "id": "unite_user", "param": { "login_mail": "test@test.com", "pwd": "12345", } } ] }
Пример успешного ответа сервера
{ "success": true, "time": "2019-12-26T13:07:50+03:00", "unite_user": { "success": true } }
Пример ответа сервера с ошибкой
{ "success" : true, "time" : "2019-12-26T13:07:50+03:00", "unite_user" : { "time" : "2019-12-26T13:07:50+03:00", "success" : false, "error_code" : 101187, "error_message" : "you cannot unite RTK subscribers" }