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