Пользователям, авторизованным под учетной записью ЛитРес, предоставляется возможность привязать с своему аккаунту учетную запись социальной сети.
Примечание: для удаления привязки к аккаунту социальной сети используется функция 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
}
}