Позволяет пользователю давать подсказки «Посреднику» (рекомендательной системе поиска интересных произведений). Система «Посредник» влияет на подбор книг для рассылки пользователю, на содержимое главной страницы и на другие подобные места.
Если пользователь подписан на какие-то сущности (авторов, серии, теги), то связанные с ними произведения появятся в поле зрения пользователя (в т. ч. в рассылках) с вероятностью близкой к 100%. И напротив, если пользователь принудительно «отписался», то практически наверняка он больше не увидит рекомендаций по таким произведениям.
Чтобы получить перечень подписок на автора/серию/тег используйте метод r_subscr_to_item_state.
ID функции
w_subscr_to_item
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
subscr* – режим подписки на сущность. Может принимать следующие значения:
- always – всегда получать уведомления о новинках данного автора/серии/пр.;
- never – никогда не получать уведомления о новинках данного автора/серии/пр.;
- default – аннулировать настройки для данного объекта и предоставить «Посреднику» право их выбора или игнорирования по своему усмотрению.
entity* – сущность, подписками на которую следует управлять. Возможные значения:
- person – управлять подпиской на авторов;
- sequence – управлять подпиской на серию;
- tag – управлять подпиской на тег;
id* – ID объекта, на который следует оформить подписку.
Возвращаемые значения
Отсутствуют.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101021 | Неизвестный режим подписки. | Параметр subscr содержит недопустимое значение, отличное от always/never/default. |
101022 | Неизвестная сущность подписки. | Параметр entity содержит недопустимое значение, отличное от person/sequence/tag. |
101023 | В базе отсутствует объект с указанным ID. | В параметре id передано число, не соответствующее ни одному автору, серии или тегу. |
Пример запроса на сервер
{ "sid": "f121e02084344f06da1a5213999e8fcG", "app": "1", "time": "2015-04-22T13:49:02+03:00", "sha": "acde0e9919a273c3a5f363eb8abe3df49fabbf768086b4ec6ecccbbc0b4d9b12", "requests": [ { "func": "w_subscr_to_item", "id": "subscr_to_item", "param": { "subscr": "always", "entity": "person", "id": "4658542" } } ] }
Пример ответа сервера
{ "success": true, "time": "2014-11-07T16:21:02+03:00", "subscr_to_item": { "success": true } }