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

ID функции

r_browse_quotes

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

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

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

art* – идентификатор книги, цитаты из который необходимо получить;
sort – порядок, в котором следует сортировать цитаты. Возможные значения:

• best – в начале отдавать лучшие цитаты;
• new – в начале отдавать самые новые отзывы;
• default – на усмотрение сервера (по-умолчанию).

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

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

cnt* – общее количество цитат объекта;
quotes* – массив, содержащий информацию обо всех найденных цитатах:

• id* – идентификатор цитаты;
• nickname* – имя (или псевдоним) автора цитаты;
• user_id* – идентификатор пользователя, являющегося автором цитаты;
• quote_html* – текст цитаты (фрагмент XHTML);
• pro* – число «положительных» оценок на эту цитату;
• contra* – число «отрицательных» оценок на эту цитату;
• is_good – признак, что цитата была оценена текущим пользователем. Принимает значение «1» в случае положительной оценки и «0» в случае отрицательной. В случае, если цитата не была оценена, атрибут отсутствует в ответе.

Если у объекта отсутствуют цитаты, то массив quotes будет пустым.

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

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_browse_quotes",
                 "id": "browse_quotes",
                 "param": {
                   "art": "100500",
                   "sort": "best",
                   "limit": ["0","5"]
                 }
           }
   ]
}

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

{
  "success": true,
  "time": "2014-11-07T16:21:02+03:00",
  "browse_quotes" : {
    "cnt" : "68",
	"success" : true,
    "quotes" : [
        {
          "id": "65830123-26b8-4b07-8098-c18229e5026f",
          "nickname": "chitatel_from_hell",
          "user_id": "13",
          "quote_html": "<p>Текст цитаты</p>",
          "pro": "0",
          "contra": "100",
          "is_good": "1"
          }, 
        {
          ...
        }
          ...
    ]
  }
}