Если у пользователя имеется несколько аккаунтов на ЛитРес, то их можно объединить. При этом все остатки на счетах и купленные книги суммируются и остаются на том аккаунте, от имени которого инициируется объединение. Второй же аккаунт, присоединяемый к текущему, полностью удаляется. Функция может оказаться особенно полезной в следующем сценарии: приложение при первом запуске автоматически регистрирует пользователя, создавая ему случайный логин/пароль («авторег») и позволяя пользователю пользоваться магазином без дополнительных усилий по регистрации.
В какой-то момент пользователь вспоминает, что у него уже есть учетная запись на ЛитРес и у него возникает потребность получить доступ ко всему принадлежащему ему контенту. В этот момент можно объединить аккаунты, в том числе «прозрачно» для пользователя, и он, просто введя уже существующие e-mail/пароль, получит вместо ошибки «такая учетная запись уже существует, переименование невозможно» нормально работающий объединенный аккаунт.
При этом акцептором является именно основной аккаунт (т.е. аккаунт, в который мы авторизуемся), и после объединения сохраняется id авторизованного юзера.
Примечание: 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 | Невозможно объединение пользователей, у которых имеется подписка «Ростелеком» |
| 103005 | Абонемент есть у обоих пользователей, объединение невозможно! Обратитесь в техподдержку Литрес! | Абонемент есть у обоих пользователей, объединение невозможно! Обратитесь в техподдержку Литрес! |
| 103006 | Подписка есть у обоих пользователей, объединение невозможно! Обратитесь в техподдержку Литрес! | Подписка есть у обоих пользователей, объединение невозможно! Обратитесь в техподдержку Литрес! |
Пример запроса на сервер
{
"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"
}