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

ID функции

r_browse_persons

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

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

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

id – массив ID персон, информацию о которых необходимо запросить;
uuid – массив external_id персон, информацию о которых необходимо запросить (необязательный параметр может использоваться вместо коротких id).
top_n_arts, top_n_genres, grammatical_case, descr – идентично одноименным параметрам из запроса r_search_persons.

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

persons* – массив, содержащий информацию о запрошенных персонах. Выдача идентична получаемой в r_search_persons (за отсутствием ненужного здесь параметра match_weight).
Если не было найдено ни одного автора, удовлетворяющей поисковому запросу, то массив persons будет пустым.

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

error_code	error_message	Описание
101075	Недопустимое значение в топе по книгам	В параметре top_n_arts допустимы только целые положительные числа от 1 до 10.
101076	Недопустимое значение в топе по жанрам	В параметре top_n_genres допустимы только целые положительные числа от 1 до 10.
101080	Некорректный флаг склонения ФИО персон	В параметре grammatical_case указано значение, отличное от «1».
101081	Некорректный флаг описания	В параметре descr указано значение, отличное от «1».
101084	Некорректный список персон	Параметр id не может содержать более чем 100 элементов.

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

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_browse_persons",
                 "id": "browse_persons",
                 "param": {
                   "id": ["100500"],
                   "top_n_arts": "3",         
                   "top_n_genres": "3",         
                   "grammatical_case": "1",   
                   "descr": "1"
                 }
           }
   ]
}

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

{
  "success": true,
  "time": "2014-11-07T16:21:02+03:00",
  "browse_persons" : {
    "success" : true,
    "persons" : [
        {
          "id": "100500",
          "last_update": "2015-05-24T11:55:07+03:00",
          "full_name": "Александр Сергеевич Пушкин",
          "first_name": "Александр",
          "last_name": "Пушкин",
          "middle_name": "Сергеевич",
          "last-rodit": "Пушкина",
          "last-dateln": "Пушкину",
          "last-vinit": "Пушкина",
          "last-tvorit": "Пушкиным",
          "last-predl": "Пушкине",
          "full-rodit": "Александра Сергеевича Пушкина",
          "full-dateln": "Александру Сергеевичу Пушкину",
          "full-vinit": "Александра Сергеевича Пушкина",
          "full-tvorit": "Александром Сергеевичем Пушкиным",
          "full-predl": "Александре Сергеевиче Пушкине",
          "inverse-full-name": "Пушкин Александр",
          "arts_n": "32",
          "reviews_n": "22",
          "lvl": "4",
          "img": "http://www.litres.ru/static/authors/100/45142.jpg",
          "description_html": "<p>Великого русского писателя, поэта и драматурга Александра Сергеевича Пушкина знают сегодня во всем мире, что не удивительно, ведь этот талантливейший человек подарил миру такие произведения, как «Евгений Онегин», «Медный всадник», «Дубровский», а также всем знакомые сказки («Сказка о рыбаке и рыбке», «Сказка о мертвой царевне» и др.). Сегодня критики в своих исследованиях называют автора создателем современного русского литературного языка. Ценители русской литературы оставляют отзывы на произведения поэта и стремятся скачать все книги Александра Пушкина в fb2, txt, epub, pdf или других форматах, чтобы загрузить их на свой ПК, ридер или планшет и перечитывать в свободное время. </p>",
          "top_arts": [
            {
              "id": "8604574",
              "name": "Сказки Пушкина",
              "cover": "http://www.litres.ru/pub/c/cover/11399521.jpg",
              "marks": "9.9"
            },
            {
              ...
            }
          ],
          "top_genres": [
            {
              "id": "193",
              "name": "Поэзия",
              "cover": "http://www.litres.ru/pub/c/cover/08787189.jpg",
              "arts_n": "5"
            },
            {
              ...
            }
          ]}, 
        {
          ...
        }
              ...
    ]
  }
}