Позволяет пользователю давать подсказки «Посреднику» (рекомендательной системе поиска интересных произведений). Система «Посредник» влияет на подбор книг для рассылки пользователю, на содержимое главной страницы и на другие подобные места.
Если пользователь подписан на какие-то сущности (авторов, серии, теги), то связанные с ними произведения появятся в поле зрения пользователя (в т. ч. в рассылках) с вероятностью близкой к 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
}
}