Created by Кристина Курашова, last modified on авг. 24, 2018

ID функции

r_my_quotes_all

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

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

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

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

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

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

  • id* – ID книги;
  • type* – тип книги. Возможные значения:
    • 0 – электронный текст (FB2/FB3);
    • 4 – PDF-книга;
    • 1 – аудиокнига;
    • 11 – Gardner books;
  • title* – название книги;
  • persons – массив, содержащий информацию о всех персонах книги (см. запрос поиска персон). Каждая персона описана следующими элементами:
    • id* – ID персоны;
    • full_name* – полное ЛитРес-название персоны;
    • lvl* – экспертный рейтинг персоны (целое значение от 1 до 5). Отражает ценность персоны с т.з. продаж: 1 – «мусорный» автор, а 5 – автор бестселлеров;
    • type – тип персоны (см. type в запрос поиска персон)
  • cover – URL до обложки книги (может быть полным, с доменом, либо относительным);
  • cover_h – высота обложки в пикселях;
  • cover_w – ширина обложки в пикселях;
  • base_price* – базовая цена книги в рублях;
  • final_price* – итоговая цена книги в рублях с учётом активных скидок («магия», определяющая какую часть покупки можно оплатить бонусами и пр. здесь не учитывается);
  • inapp_price – цена InnApp'а в запрошенной валюте (см. currency в запросе);
  • inapp_name – название InnApp'а;
  • free – признак бесплатной книги (если «1» – книга доступна бесплатно);
  • in_basket – признак, что книга находится в корзине пользователя, но еще не куплена. Значение этого объекта – ID записи в корзине;
  • my ­– признак, что эта книга уже уже куплена/получена этим пользователем («1» – эта книга уже есть у пользователя);
  • biblio_selfservice – признак, что текущий пользователь является простым или гибридным библиочитателем. Возможные значения:
    • delayed – книга доступна для выдачи в библиотеке после запроса;
    • instant – книга доступна для выдачи в библиотеке сразу. Например, если это «коммерческая» библиотека. Или обычная, но с режимом самообслуживания, когда у пользователя достаточно прав «Взять себе», а у библиотеки – достаточно финансов оплатить эту книговыдачу;
    • impossible – книга недоступна для выдачи через библиотеку;
    • requested – читатель отправил в библиотеку запрос на получение книги и ожидает его одобрения;
    • received – книга уже получена пользователем (при этом my=1);
  • mark_1 – общее кол-во пользователей, оценивших данную книгу на «1»;
  • mark_2 – общее кол-во пользователей, оценивших данную книгу на «2»;
  • mark_3 – общее кол-во пользователей, оценивших данную книгу на «3»;
  • mark_4 – общее кол-во пользователей, оценивших данную книгу на «4»;
  • mark_5 – общее кол-во пользователей, оценивших данную книгу на «5»;
  • quotes* – массив, содержащий информацию обо всех найденных цитатах запрашиваемого пользователя для данного арта:
    • id* – идентификатор цитаты;
    • quote_html* – текст цитаты (фрагмент XHTML);
    • pro* – число «положительных» оценок на эту цитату;
    • contra* – число «отрицательных» оценок на эту цитату;
    • last_update* – дата последнего изменения (считаем опубличивание последним изменением) цитаты (в ISO 8601 формате даты-времени с UTC, например «2013-10-07T16:00:00+03:00»;
    • is_good – признак, что цитата была оценена текущим пользователем. Принимает значение «1» в случае положительной оценки и «0» в случае отрицательной. В случае, если цитата не была оценена, атрибут отсутствует в ответе.

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

error_code

error_message

Описание

 

 

 

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

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_my_quotes_all",
                 "id": "my_quotes_all",
                 "param": {
                   "limit": ["0","40"]
                 }
           }
   ]
}

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

{
  "success": true,
  "time": "2014-11-07T16:21:02+03:00",
  "my_quotes_all": {
    "success": true,
    "arts_quotes": [
      {
        "art": "171966",
        "type": "0",
        "title": "Евгений Онегин",
        "persons": [
          {
            "id": "45142",
            "full_name": "Александр Сергеевич Пушкин",
            "img": "http://www.litres.ru/static/authors/100/45142.jpg",
            "type": "1"
          }
        ],
        "cover": "/pub/c/cover/08787189.jpg",
        "cover_h": "798",
        "cover_w": "570",
        "base_price": "0",
        "final_price": "0",
        "inapp_price ": "29.95",
        "inapp_name": "ru.litres.app.refill_99.XXL",
        "free": "1",
        "in_basket": "466557",
        "my": "1",
        "biblio_selfservice": "received",
        "reviews_n": "15",
        "mark_1": "2",
        "mark_2": "12",
        "mark_3": "10",
        "mark_4": "33",
        "mark_5": "23",
        "quotes": [
          {
            "id": "100500",
            "quote_html": "<p>Текст цитаты</p>",
            "pro": "0",
            "contra": "100",
      		"added": "2013-10-07T16:00:00+03:00",
            "is_good": "1"
          }
        ]
      }
    ]
  }
}