Данный запрос позволяет получить информацию о библиотеках, которые обслуживают текущего пользователя. Обычно это одна библиотека, но может быть и несколько.

ID функции

r_library_status

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

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

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

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

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

libhouses* – массив, который содержит информацию о библиотеках. Для каждой библиотеки будут возвращены следующие элементы:

id* – ID библиотеки;
name* – название библиотеки (может быть длинным), значение НЕ возвращается, если app_hide_name = 1;
logo_width – ширина логотипа, если он есть (высота логотипа всегда равна 72 px);
path – путь, по которому расположен логотип библиотеки;
libhouse_group – номер группы библиотек, если он определен для данной библиотеки;
is_school – возвращается значение «1», если группа является «школьной», и 0 – для других групп;
is_biblioman – возвращается значение «1», если запрос выполняется для пользователя с ролью «библиотекарь». Значение нужно при регистрации;
is_university – возвращается значение «1», если библиотека является университетской, иначе – 0;
move_to_fund – возвращается значение «1», если после авторизации рекомендуется отправить читателя в раздел «В библиотеке»;
libhouse_face* – номер фейса, к которому привязана данная библиотека;
library_domain* – домен фейса, к которому привязана данная библиотека;
lib_mail – почта контактного лица библиотеки, если есть;
lib_phone – телефон контактного лица библиотеки, если есть;
puid* – номер читательского билета текущего пользователя в этой библиотеке;
is_blocked – возвращается значение «1», если текущий пользователь заблокирован в этой библиотеке, иначе – 0;
block_time – время и дата блокировки пользователя. Значение возвращается, если is_blocked=1;
block_reason – причина блокировки (текстовое сообщение). Значение возвращается, если is_blocked=1;
lib_rules* - html текст, содержащий правила работы с библиотекой;
app_hide_name - параметр отвечающий за отображение названия библиотеки, если 1 - name не выводится.

Если у текущего пользователя нет библиотечных аккаунтов – возвращается пустой массив libhouses.

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

Возможные ошибки описаны в статье «Обработка ошибок».

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

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [ 
           {
                 "func": "r_library_status",
                 "id": "user_libraries"
           }
   ]
}

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

{
   "success": true,
   "time": "2014-11-07T16:21:02+03:00",
   "user_libraries": {
      "success": true,
      "libhouses": {
         "id": "1438870",
         "name": "Дальнегорская муниципальная библиотека имени Бертольда Шварца",
         "logo_width": "112",
         "path": "static/img/librarylogo/100/25/39/34/32523212.png",
         "library_domain": "dalnelib.library.litres.ru",
		 "lib_fio": "Смирнова Александра Владимировна",
		 "lib_mail": "lib@email.ru",
		 "lib_phone": "79606665544",
		 "puid": "156785315",
		 "lib_rules": "Получите на руки <b>5 свободных книг</b> из фонда библиотеки или из полного каталога стоимостью дешевле <b>500 p</b> (количество одинаковых книг в библиотеке не более 5). Запросите дополнительные - библиотекарь выдаст их при первой возможности. Читайте полную версию книги <b>14 дней</b>, а потом она вернется в библиотеку"
      }
   }
}