Пользователям, авторизованным под учетной записью ЛитРес, предоставляется возможность привязать с своему аккаунту учетную запись социальной сети.
Примечание: для удаления привязки к аккаунту социальной сети используется функция 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 – идентификатор пользователя Вконтакте |
fb | access_token – одноразовый токен | – | |
Mail.Ru | ma | access_token – одноразовый токен | uids – идентификатор пользователя mail.ru |
Одноклассники | ok | access_token – одноразовый токен | session_secret_key – сессионный ключ |
gp | access_token – одноразовый токен | – | |
MOS.RU | ms | access_token – одноразовый токен | – |
Сбербанк | sb | access_token – одноразовый токен | – |
ig | access_token – одноразовый токен | – |
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101027 | Ошибка при попытке авторизации через социальную сеть | По каким-то причинам переданные данные не были обработаны сервером социальной сети. Возможные причины:
|
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 } }