Пользователям предоставляется возможность просматривать рандомные публичные цитаты для дальнейшего голосования без привязки к карточке книги. Требования к цитатам: публичность, наличие пользовательских оценок в сумме +- не менее 0, количество символов не менее 120, последний символ – конечный знак препинания (точка, знак вопроса или восклицательный знак).
ID функции
r_random_quotes
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
limit – ограничение на количество возвращаемых цитат. Работает аналогично инструкции limit в MySQL и в запросе представлен одним числом либо массивом из двух чисел N,M. Если limit указан – возвращается M цитат, начиная с цитаты N (у первой – номер 0). Если limit не задан, по умолчанию передается значение «0, 20».
Возвращаемые значения
quotes* – информация о всех найденных цитатах. Возвращается в виде массива и для каждой цитаты содержит следующие элементы:
- id* – ID цитаты;
- quote_html* – текст цитаты (фрагмент XHTML);
- pro* – число «положительных» оценок на эту цитату;
- contra* – число «отрицательных» оценок на эту цитату;
- is_good – признак, что цитата была оценена текущим пользователем. Принимает значение «1» в случае положительной оценки и «0» в случае отрицательной. В случае, если цитата не была оценена, атрибут отсутствует в ответе;
- art* – ID книги, в которой содержится данная цитата;
- title* – название книги, в которой содержится данная цитата;
- persons* – информация о персонах арта с type=0 по умолчанию. Возвращается в виде массива и содержит:
- full_names* – полное имя персоны (Сергей Лукъяненко);
- id* – идентификатор персоны.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
| 101071 | Недопустимое значение в лимите возвращаемых элементов | В параметре limit должен передаваться массив из двух целых не отрицательных чисел либо одно число |
Пример запроса на сервер
{
"sid" : "5d84dw2td9c96f9abx436fe14073943a",
"requests" : [
{
"param" : {
"limit" : [
0,
5
]
},
"func" : "r_random_quotes",
"id" : "random_quotes"
}
],
"mobile_app" : 115,
"sha" : "9c078eb4bc13f972e25a927083ca5ff9c67655315eb6c3bc8922a7c017f3d8dc",
"time" : "2019-11-21T19:26:06+03:00"
}
Пример ответа сервера
{
"random_quotes" : {
"quotes" : [
{
"art" : 4236675,
"contra" : 0,
"id" : "6c517d79-13e7-11e2-86b3-b737ee03444a",
"persons" : [
{
"full_name" : "Айн Рэнд",
"id" : 47292
}
],
"pro" : 0,
"quote_html" : "<p>И уровень человеческой продуктивности – уровень его вознаграждения. В этом состоит смысл существования, чьим инструментом и символом являются деньги.</p>",
"title" : "Атлант расправил плечи"
},
{
"art" : 22858761,
"contra" : 0,
"id" : "2aef47ab-ed47-11e6-a56b-0cc47a520474",
"persons" : [
{
"full_name" : "Татьяна Устинова",
"id" : 45292
}
],
"pro" : 0,
"quote_html" : "<p>меня можно исправить. Женщины всегда так делают. Если логика или здравый смысл говорят вам одно, вы всегда сами убеждаете себя в противоположном.</p>",
"title" : "Селфи с судьбой"
}
],
"success" : true
},
"success" : true,
"time" : "2019-11-21T19:26:15+03:00"
}
Пример ответа сервера с ошибкой
{
"error_message" : "sid invalid",
"error_code" : 101000,
"success" : false,
"time" : "2019-11-21T19:28:07+03:00"
}