Все запросы к API требуют передачи валидного SID'а, поэтому первым делом необходимо авторизоваться под созданной ранее учетной записью или же представиться системе в качестве анонимного пользователя (с логином «Anonymous» и паролем «0»). При этом будет создана новая сессия и запрос вернет валидный SID.
Если у вас уже имеется SID, полученный при прошлой авторизации, и вы хотите продлить его «валидность», то можно передать пару логин/пароль + старый SID. При этом сервер попытается авторизовать пользователя по старому SID и если сессия уже не валидна, то будет создана новая сессия. В любом случае (новый или старый) рабочий SID будет отдан клиенту.
Дальнейшая обработка запроса идет уже в контексте авторизованного пользователя (однако, если авторизация не была успешной, вы рискуете получить ошибки в других вызовах, будьте к этому готовы).
ID функции
w_create_sid
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
login* – логин (в этом параметре можно передать mail или номер телефона). Для авторизации под анонимным пользователем используйте логин «Anonymous»;
pwd* – пароль. Для авторизации под анонимным пользователем используйте пароль «0»;
sid – SID, актуальность которого неизвестна.
Возвращаемые значения
sid – актуальный (валидный) идентификатор сессии;
country – сведения о гео-локации пользователя в стандарте ISO 3166-1;
region – регион пользователя (необязательный параметр);
city – город пользователя (необязательный параметр);
currency – соответствующая гео-локации валюта (необязательный параметр).
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101013 | Неверное сочетание логина/пароля. | В запросе передана некорректная комбинация login/pwd (или login/cur_pwd). |
101014 | Слишком много ошибок авторизации, доступ временно заблокирован. | При последнем запросе был превышен лимит ошибочных попыток авторизации с указанием неверных сочетаний login/pwd. Попробуйте повторить запрос через некоторое время. |
| 101051 | Biblio user is blocked. | Запрещена авторизация заблокированному школьнику. |
101068 | В этом приложении запрещено авторизовываться под учётной записью библиотекаря. | В запросе авторизации был передан login/pwd от учётной записи библиотекаря из проекта «ЛитРес: Библиотека». Но использование учётных записей с такими правами в текущем приложении запрещено. |
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"requests": [
{
"func": "w_create_sid",
"id": "log_me_in_baby",
"param": {
"login": "new@mail.ru",
"pwd": "foo_bar",
"sid": "78838d3c7fbf640a4c52956569bef3c685"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"log_me_in_baby": {
"success": true,
"sid": "78838d3c7fbf640a4c52956569bef3c685 (still a string, remember!)",
"country": "RUS"
}
}