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

Нельзя объединять учетную запись пользователя школьной библиотеки

Учетные записи пользователей проекта «ЛитРес: Школа» не имеют возможности объединения

101178Same library users merge forbiddenНельзя объединять учетные записи пользователей одной библиотеки
101186More than one phoneУ пользователей разные номера телефонов
101187You 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"
   }