Пользователям предоставляется возможность ставить книгам оценки. Оценка может принимать целое значение от 1 до 5.
ID функции
w_add_item_rating
Кто может вызывать
Любой пользователь
Авторизованное приложение
Принимаемые параметры
item_id* – идентификатор объекта, на который оставляется отзыв. Целое положительно число;
entity* – тип объекта, на который оставляется отзыв. Возможные значения:
person – отзыв на автора (<not implemented yet>);
sequence – отзыв на серию (<not implemented yet>);
art – отзыв на книгу;
collection – отзыв на категорию (<not implemented yet>);
rating* – оценка книги, проставленная пользователем. Целое число от 1 до 5 (где 1 – плохо, 5 – отлично).
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101088 | Неизвестная сущность для оставления отзыва | Параметр entity содержит недопустимое значение, отличное от:
|
101087 | Несуществующая книга | Книга, к которой произошла попытка добавления оценки, не существует |
101085 | Несуществующая серия | Серия, к которой произошла попытка добавления оценки, не существует |
101086 | Несуществующая коллекция | Коллекция, к которой произошла попытка добавления оценки, не существует |
101082 | Несуществующая персона | Персона, к которой произошла попытка добавления оценки, не существует |
101091 | Неверный параметр rating | Значение оценки (rating) должно быть целым числом от 1 до 5 |
101092 | Превышен лимит выставления рейтинга | Вы оставили очень большое кол-во оценок и вам запрещается голосовать 2 суток |
Пример запроса на сервер
{
"sid": "f121e02084344f06da1a5213999e8fcG",
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"requests": [
{
"func": "w_add_item_rating",
"id": "add_book_rating",
"param": {
"item_id": "120500",
"entity": "art",
"rating": "3"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"add_book_rating": {
"success": true
}
}