Пользователям, авторизованным под учетной записью ЛитРес, предоставляется возможность привязать с своему аккаунту учетную запись социальной сети.

Примечание: для удаления привязки к аккаунту социальной сети используется функция w_detach_socnet.

ID функции

w_attach_socnet

Кто может вызывать

Авторизованный пользователь.
Авторизованное приложение.

Принимаемые параметры

socnet* – социальная сеть, аккаунт которой будет привязан у учетной записи пользователя в ЛитРес. Допустимые значения (описание см. в таблице ниже):

  • tw_reverse;
  • tw;
  • vk;
  • fb;
  • ma;
  • ok;
  • gp;
  • ms;
  • sb;
  • ig;
  • vk_miniapp.

token* – одноразовый ключ, полученный от социальной сети (строковое значение);
token_verifier – дополнительные данные, необходимые для привязки через токен (строковое значение).
В зависимости от типа социальной сети в параметрах передаются различные значения:

 Соцсеть

socnet*

token*

token_verifier

Twitter под операционной системой iOS (используется reverse-auth)

tw_reverse

oauth_token – одноразовый токен

oauth_verifier – верификационный ключ

Twitter под под любой операционной системой, отличной от iOS

tw

oauth_token – одноразовый токен

oauth_verifier – верификационный ключ

ВКонтакте

vk, vk_miniapp

access_token – одноразовый токен

uids – идентификатор пользователя Вконтакте

Facebook

fb

access_token – одноразовый токен

Mail.Rumaaccess_token – одноразовый токенuids – идентификатор пользователя mail.ru
Одноклассникиokaccess_token – одноразовый токенsession_secret_key – сессионный ключ
Googlegp

access_token – одноразовый токен

MOS.RUmsaccess_token – одноразовый токен
Сбербанкsbaccess_token – одноразовый токен
Instagramigaccess_token – одноразовый токен

Возвращаемые значения

Отсутствуют.

Возможные ошибки

error_code

error_message

Описание

101027

Ошибка при попытке авторизации через социальную сеть

По каким-то причинам переданные данные не были обработаны сервером социальной сети. Возможные причины:

  • истек TTL токена;

  • ошибка в строке токена или дополнительных данных;

  • в запросе указан токен от другой соцсети;

  • технические проблемы на стороне сервера соцсети.

101053

invalid params

В запросе передан некорректный параметр, отсутствуют обязательные параметры или передано недопустимое значение параметра.

101054

socnet already attached to another user [login/mail]

Указанный аккаунт социальной сети уже привязан к другой учетной записи в системе ЛитРес

Пример запроса на сервер

{
  "sid": "f121e02084344f06da1a5213999e8fcG",
  "app": "1",
  "time": "2014-11-07T16:21:02+03:00",
  "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
  "requests": [
          {
                "func": "w_attach_socnet",
                "id": "attach_socnet",
                "param": {
                  "socnet": "tw_reverce",
                  "token": "78838d3c7fbf640a4c52956569bef3c685",
                  "token_verifier": "1d23g33g4"
                }
          }
  ]
}

Пример ответа сервера

{
  "success": true,
  "time": "2014-11-07T16:21:02+03:00",
  "attach_socnet": {
    "success": true
  } 
}