С помощью этого запроса читатель может выгрузить все библиотечные книги, с которыми он взаимодействовал: выданные, запрошенные, возвращенные в библиотеку, книги с отказами в выдаче.

ID функции

r_my_biblio_books

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

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

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

limitannocurrency, atype – идентично одноименным параметрам из запроса r_search_arts.

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

arts* – идентично одноименному массиву в ответе на запрос r_search_arts, за исключением ненужного тут значения match_weight. Кроме того в массиве arts может присутствовать атрибут region_restriction – ограничение на показ/продажу книги в стране или регионе, где книга запрещена (определяется по GeoIP запросившего пользователя). Может принимать следующие значения:

  • 1 – запрещена продажа книги. Карточка книги, в том числе её обложка, рецензии, цитаты и т. д. будут показаны пользователю, но будет отсутствовать возможность купить такую книгу. Возвращается в виде строки;
  • 2 – запрещен показ книги. Книгу с таким ограничением пользователь не увидит, а так же она будут отсутствовать в выдаче при выполнении запроса поиска по книгам. Возвращается в виде строки.

Дополнительно для каждой книги будут возвращаться следующие данные:
verdict* – текущий библиотечный статус книги. Возвращается одно из возможных значений: 

  • requested – книга запрошена пользователем, но не выдана библиотекой;
  • canceled – запрос на книгу был отменен пользователем;
  • returned – книга была возвращена в библиотеку;
  • rejected – библиотекарь отказал в выдаче запрошенной пользователем книги;
  • direct_loan – книга выдана читателю;

approved* – дата присвоения библиотечного статуса книге в ISO-формате «ГГГГ-ММ-ДД ЧЧ:ММ:СС», например, «2019-12-15 14:07:13»;
s_last_biblio_rejected_reason – причина отказа в выдаче запрошенной пользователем книги. Возвращается только в случае, если verdict=rejected.


Книги в массиве arts будут отсортированы по времени изменения библиотечного статуса, первыми идут самые свежие.
Если у пользователя нет книг с библиотечной историей, то массив arts будет пустым.

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

error_code

error_message

Описание

101071

Недопустимое значение в лимите возвращаемых элементов

В параметре limit должен передаваться массив из двух целых не отрицательных чисел либо одно число.

101072

Некорректный флаг аннотации

В параметре anno указано значение, отличное от «1».

101073

Указана некорректная валюта

В параметре currency допустимы только следующие валюты:

  • RUB – российские рубли;
  • USD – доллары США;
  • EUR – евро;
  • PLN – польские злотые.

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

{ 
   "app":1,
   "time":"2019-12-15T21:52:58+03:00",
   "sid":"5sbddubcf28r6f3q7k2necc5179232c3",
   "sha":"8773b33923aea464566d7d3dc7c08fd7568f115f54bf47c9a3de0986596c68ac",
   "requests":[ 
      { 
         "id":"my_biblio_books",
         "param":{ 
            "currency":"USD",
            "atype":1,
            "limit":[ 
               0,
               4
            ],
            "anno":1
         },
         "func":"r_my_biblio_books"
      }
   ]
}


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

{
"my_biblio_books":{
	"arts":[
	{
		"annotation":"<p>В одно отнюдь не прекрасное утро к любительнице частного сыска Даше Васильевой приехала подруга Лена Гладышева и обвинила в том, что та тайно подсунула в почтовый ящик двадцать тысяч долларов. Но это была не Даша! Муж Лены Олег исчез год назад при загадочных обстоятельствах. Лена вначале бедствовала, но от помощи гордо отказалась... Только все стало налаживаться, и бац! Кто-то подбросил ей якобы от имени Олега деньги. Подруги решили выяснить у консьержки, кто подложил конверт. Та сказала, что это была почтальонша Соня. Пока Даша беседовала с Соней, какие-то отморозки убили консьержку и тяжело ранили Лену. Почтальонша описала мужика, передавшего ей деньги. Похоже, это был... Олег. Неужели он сбежал от жены и сына? Почему?.. Менты мышей не ловят, считают происшедшее простым совпадением. Ну ничего, Дашутка всех их умоет, особенно полковника Дегтярева! Она отыщет Олега – живого или мертвого!..</p>\n",
		"approved":"2019-12-15 14:07:13",
		"available":1,
		"available_date":"2011-03-28 23:07:20",
		"base_price":"1.71",
		"biblio_busy":"1",
		"biblio_fund":"1",
		"biblio_queue_size":0,
		"biblio_selfservice":"received",
		"can_preorder":0,
		"chars":483069,
		"cover":"http://www.litres.ru/static/bookimages/01/72/42/01724265.bin.dir/01724265.cover.jpg",
		"cover_h":549,
		"cover_w":350,
		"drm":0,
		"exp_update_freq":1,
		"final_price":"1.37",
		"first_time_sale":"2007-12-11 01:02:26",
		"genres":[
			{
			"id":5262,
			"name":"иронические детективы"
			}
			],
		"id":"118860",
		"images":0,
		"isbn":"978-5-425-00016-3",
		"lang":"rus",
		"last_release":"2011-03-28 23:10:18",
		"last_update":"2016-07-19 13:27:35",
		"ll_avg_marks":3.5527,
		"ll_marks_n":0,
		"lvl":5,
		"mark_1":0,
		"mark_2":2,
		"mark_3":0,
		"mark_4":2,
		"mark_5":27,
		"minage":0,
		"my":1,	
		"persons":[
			{
			"full_name":"Дарья Донцова",
			"id":44336,
			"img":"http://www.litres.ru/static/authors/100/00/04/43/00044336.jpg",
			"lvl":4,
			"type":0
			}
			],
		"publisher":"Эксмо",
		"requested":"2019-12-15 14:07:13",
		"reviews_n":0,
		"sequences":[
			{
			"arts_n":53,
			"id":612,
			"name":"Любительница частного сыска Даша Васильева",
			"reviews_n":1,
			"sequence_number":20
			}
			],
		"title":"Гарпия с пропеллером",
		"type":0,
		"valid_till":"2019-12-29 23:59:00",
		"verdict":"direct_loan",
		"year":2003,
		"year_written":"2003"
	},
	{
		"annotation":"<p>Невероятные события просто падают на голову симпатичной преподавательнице французского языка Даше Васильевой. Стоило поехать отдыхать, как пожалуйста – чуть ли не на ее глазах убивают «короля зубной пасты». Полиция готова закрыть дело за неимением улик, однако Даше хочется разобраться во всем до конца. Но это не легко. Оказывается, смерти магната хотели все – жена, дочери, зять… Неизвестные злоумышленники во всю пытаются помешать Даше, убивая свидетелей. Но она решает не сдаваться и расставить в этой запутанной истории все точки над i.</p>\n",
		"available":1,
		"available_date":"2011-03-28 23:10:09",
		"base_price":"1.71",
		"biblio_busy":"0",
		"biblio_fund":"1",
		"biblio_queue_size":1,
		"biblio_selfservice":"requested",
		"can_preorder":0,
		"chars":327662,
		"cover":"http://www.litres.ru/static/bookimages/01/72/42/01724285.bin.dir/01724285.cover.jpg",
		"cover_h":552,
		"cover_w":350,
		"drm":0,
		"exp_update_freq":1,
		"final_price":"1.37",
		"first_time_sale":"2007-12-14 08:52:33",
		"genres":[
			{
			"id":5262,
			"name":"иронические детективы"
			}
			],
		"id":"118863",
		"images":0,
		"isbn":"978-5-425-00019-4",
		"lang":"rus",
		"last_release":"2011-03-28 23:12:34",
		"last_update":"2016-07-19 13:27:35",
		"ll_avg_marks":3.606,
		"ll_marks_n":0,
		"lvl":5,
		"mark_1":0,
		"mark_2":0,
		"mark_3":2,
		"mark_4":9,
		"mark_5":39,
		"minage":0,
		"persons":[
			{
			"full_name":"Дарья Донцова",
			"id":44336,
			"img":"http://www.litres.ru/static/authors/100/00/04/43/00044336.jpg",
			"lvl":4,
			"type":0
			}
			],
		"publisher":"Эксмо",
		"requested":"2019-12-15 14:04:24",
		"reviews_n":0,
		"sequences":[
			{
			"arts_n":53,
			"id":612,
			"name":"Любительница частного сыска Даша Васильева",
			"reviews_n":1,
			"sequence_number":2
			}
			],
		"title":"За всеми зайцами",
		"type":0,
		"verdict":"requested",
		"year":2001,
		"year_written":"2001"
		},
	{
		...
		},
	{
		...
		},
			],
	"success":true
	},
"success":true,
"time":"2019-12-15T21:53:06+03:00"
}