Позволяет получить список жанров по рейтингу конкретного пользователя. То есть по тем книгам, которые пользователь покупал, отметил прочитанными, взял в библиотеке, взял бесплатно, получил по любой акции, приобрел по абонементу. Выдает до 30 жанров с привязанными к ним до 20 книг.

ID функции

r_user_stat

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

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

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

limit – ограничение на количество возвращаемых жанров. Работает аналогично инструкции limit в MySQL и в запросе представлен одним числом либо массивом из двух чисел N,M. Если limit указан – возвращается M жанров, начиная с N. Если limit не задан – значение по умолчанию «0,10»;

atype - массив супер-типов, арты этих типов нужно выдавать. Например "atype" : [1,2] закажет выдачу электронных текстов (fb2 и pdf) и аудиокниг

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

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

• genre - айди жанра/тэга;

• genre_name - название жанра/тэга на языке uilang запроса (или дефолтное если нет перевода)

• top20arts - массив последних по времени взаимодействия артов пользователя, относящихся к этому жанру/тегу:

id – ID книги;
type* – тип книги. Возможные значения: 0 – электронный текст (FB2/FB3), 4 – PDF-книга, 1 – аудиокнига;
title* – название книги;
my – признак того, что эта книга уже уже куплена/получена этим пользователем (может не возвращаться на бывшие библиотечные книги и на книги, которые пользовател

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

error_code	error_message	Описание
101001	Некорректные параметры вызова	В запросе передан некорректный параметр, отсутствуют обязательные параметры или передано недопустимое значение параметра.Например: неверный формат даты в updated_from
101161	Некорректное имя ключа	Недопустимый параметр

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

{
   "time" : "2021-03-29T11:51:18+03:00",
   "app" : 1,
   "sha" : "5a9ba084a84377ddffabb2eb253f38a2db4f0effde28562c8e556706466dc586",
   "requests" : [
      {
         "func" : "r_user_stat",
         "param" : {
            "limit" : [
               0,
               10
            ],
          "atype" : [1,2]
         },
         "id" : "r_user_stat"
      }
   ],
   "sid" : "6ban0nfi56awcg3p72070ge2c845b6bd"
}

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

{
   "r_user_stat" : {
      "success" : true,
      "user_genres" : [
         {
            "genre" : "5035",
            "genre_name" : "Героическая фантастика",
            "top20arts" : [
               {
                  "id" : "133672",
                  "my" : "1",
                  "title" : "Подземка",
                  "type" : "0"
               },
               {
                  "id" : "51819561",
                  "title" : "Очень холодно",
                  "type" : "0"
               }
            ]
         },
         {
            "genre" : "5935",
            "genre_name" : "Сказочная фантастика",
            "top20arts" : [
               {
                  "id" : "51818866",
                  "title" : "Пираты Кошачьего моря. Жребий брошен!",
                  "type" : "0"
               },
               {
                  "id" : "51777310",
                  "title" : "Возраст осени",
                  "type" : "0"
               },
               {
                  "id" : "51707523",
                  "my" : "1",
                  "title" : "Секрет опричника; Преступление в слободе",
                  "type" : "0"
               }
            ]
         }
      ]
   },
   "success" : true,
   "time" : "2021-03-29T13:15:05+03:00"
}