Пользователям предоставляется возможность писать отзывы (рецензии) на книги. Все написанные отзывы проходят модерацию в ЛитРес и только после одобрения становятся доступны для широкой аудитории.
См. также [r_browse_item_reviews] Отзывы на объект.
ID функции
w_add_item_review
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
item_id* – идентификатор объекта, отзыв к которому необходимо добавить;
entity* – тип объекта, на который оставляем отзыв. Возможные значения:
- person – отзыв на автора;
- sequence – отзыв на серию;
- art – отзыв на книгу;
- collection – отзыв на категорию;
- recense − отзыв на рецензию;
- folder − отзыв на пользовательскую полку.
caption – заголовок отзыва (не более 100 символов);
review* – текст отзыва, оформленный BBCode (не менее 120 символов).
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101088 | Неизвестная сущность для оставления отзыва. | Параметр entity содержит недопустимое значение, отличное от:
|
101087 | Несуществующая книга. | Книга, к которой произошла попытка добавления отзыва, не существует. |
101085 | Несуществующая серия. | Серия, к которой произошла попытка добавления отзыва, не существует. |
101086 | Несуществующая коллекция. | Коллекция, к которой произошла попытка добавления отзыва, не существует. |
101082 | Несуществующая персона. | Персона, к которой произошла попытка добавления отзыва, не существует. |
| 101118 | Несуществующая рецензия. | Рецензия, к которой произошла попытка добавления отзыва, не существует. |
| 101119 | Несуществующая полка. | Полка, к которой произошла попытка добавления отзыва, не существует. |
101090 | Превышена допустимая длина. | Поле caption превышает допустимое кол-во символов. |
101089 | Короткая строка отзыва. | Кол-во символов в тексте отзыва (review) должно быть не менее 120 символов. |
Пример запроса на сервер
{
"sid": "5k1ec41vdn1j9yav3600aqf7av5a0tbt",
"app": "1",
"time": "2019-06-03T17:26:27+03:00",
"sha": "bfd112f9b28a20ddd9a7812868d04cae562ee157f8fab73feca33e7a8642c4bc",
"requests": [
{
"func": "w_add_item_review",
"id": "add_item_review",
"param": {
"item_id": "8",
"entity": "recense",
"caption": "Заголовок",
"review": "Рецензия на отзыв"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2019-06-03T17:26:27+03:00",
"add_item_review": {
"success": true
}
}