Для пользователей, уже прошедших авторизацию на сайте ЛитРес, существует возможность авторизации в приложении без ввода логина и пароля. Для этого на стороне сервера (сайта) генерируется «одноразовый пин» (состоящий из десятичных цифр), передав который через данный API можно авторизовать пользователя и получить актуальный SID. Время, в течение которого одноразовый пин остается валидным, невелико и обычно составляет 15 минут.
Дальнейшая обработка запроса идет уже в контексте авторизованного пользователя.

ID функции

w_pin_authorise

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

Любой пользователь
Авторизованное приложение

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

otpin* – одноразовый пин, состоящий из десятичных цифр;

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

sid – актуальный (валидный) идентификатор сессии;
country – сведения о гео-локации пользователя в стандарте ISO 3166-1;
region – регион пользователя (необязательный параметр);
city – город пользователя (необязательный параметр);
currency – соответствующая гео-локации валюта (необязательный параметр).

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

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

{
 "app": "1",
 "time": "2014-11-07T16:21:02+03:00",
 "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
 "requests": [
         {
               "func": "w_pin_authorise",
               "id": "pin_authorise",
               "param": {
                 "otpin": "906785",
               }
         }
 ]
}

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

{
"success": true,
 "time": "2014-11-07T16:21:02+03:00",
   "pin_authorise": {
  	"success": true,
  	"sid": "78838d3c7fbf640a4c52956569bef3c685",
       "country": "RUS"
 }
}