Жанровое дерево содержит все жанры, используемые в ЛитРес. Книгам присваиваются только «конечные» жанры (строки 9-13, 16-25, 36-45 в примере ответа). Все остальные поджанры (sub) предназначены только для определения иерархической структуры жанрового дерева, обладающего неограниченной вложенностью (строки 7-8, 14-15, 26-35, 46-49 в примере ответа). Учитывайте, что жанровое дерево может изменяться. Со временем, например, конечные жанры могут превратиться в поджанры (sub). Поэтому рекомендуется обновлять информацию по жанровому дереву хотя бы раз в две недели или при обнаружении книг с неизвестными идентификаторами.

ID функции

r_genres_list

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

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

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

atype – указание на сортировку жанров по супертипу книг, чтобы можно было получить количество электронных / аудио книг в жанре. Необязательный параметр. При отсутствии выводятся количества всех книг на запрашиваемом хосте. Может принимать значения:

1 – только электронные книги;
2 – только аудиокниги.

need_url – флаг-указание, что для всех жанров нужно отдать ЧПУ. Необязательный.

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

genres* – объект, описывающий все жанровое дерево. В нем расположены только поджанры:

sub – поджанр. В структуре ответа он является как бы «папкой» , в которой могут находиться конечные жанры или другие «папки»:
- Конечный жанр (строки 9-13, 16-25, 36-45 в примере ответа). Именно эти жанры присваиваются книгам;
- sub – еще один поджанр.
  - … и т. д.;
arts_n – число книг в жанре. Присутствует (гарантировано) только у конечных жанров.

Каждый поджанр или конечный жанр имеет три атрибута:

id – уникальный идентификатор объекта;
name – название объекта;
arts_n – количество книг имеющих привязку к жанру или поджанру.
url - ЧПУ жанра; отдается, если задан параметр need_url=1.

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

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

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

{
  "success": true,
  "time": "2014-11-07T16:21:02+03:00",
  "genres_list": {
    "success": true,
    "genres": [
 {
            "arts_n" : "50091",
            "id" : "201583",
            "name" : "легкое чтение",
            "sub" : [
               {
                  "arts_n" : "13126",
                  "id" : "5022",
                  "name" : "детективы",
                  "sub" : [
                     {
                        "arts_n" : "2717",
                        "id" : "5204",
                        "name" : "триллеры",
                        "url" : "knigi-boeviki-ostrosugetnaya/trillery/"
                     },
                     {
                        "arts_n" : "5195",
                        "id" : "5259",
                        "name" : "современные детективы",
                        "url" : "knigi-detektivy/sovremennye/"
                     },
                     {
                        "arts_n" : "4528",
                        "id" : "5219",
                        "name" : "зарубежные детективы",
                        "url" : "knigi-detektivy/zarubezhnye/"
                     },
                     {
                        "arts_n" : "1315",
                        "id" : "5260",
                        "name" : "полицейские детективы",
                        "url" : "knigi-detektivy/policeyskie/"
                     },
                     {
                        "arts_n" : "1581",
                        "id" : "5262",
                        "name" : "иронические детективы",
                        "url" : "knigi-detektivy/ironicheskie/"
                     },
                     {
                        "arts_n" : "731",
                        "id" : "5258",
                        "name" : "исторические детективы",
                        "url" : "knigi-detektivy/istoricheskie/"
                     },
                     {
                        "arts_n" : "1826",
                        "id" : "5261",
                        "name" : "классические детективы",
                        "url" : "knigi-detektivy/klassicheskie/"
                     },
                     {
                        "arts_n" : "519",
                        "id" : "5263",
                        "name" : "шпионские детективы",
                        "url" : "knigi-detektivy/shpionskie/"
                     },
                     {
                        "arts_n" : "455",
                        "id" : "5265",
                        "name" : "крутой детектив",
                        "url" : "knigi-detektivy/krutoy-detektiv/"
                     },
                     {
                        "arts_n" : "144",
                        "id" : "5264",
                        "name" : "политические детективы",
                        "url" : "knigi-detektivy/politicheskie/"
                     }
                  ],
                  "url" : "knigi-detektivy/"
               }
    ]
  }
}

Public : [r_genres_list] Получение дерева жанров ЛитРес