Запрос осуществляет покупку оффера, списывая его стоимость с пользовательского счета ЛитРес. В дальнейшем проверить активность оффера можно с помощью запроса r_user_offers.
Пример: пользователь хочет на неделю отключить рекламу в Android-приложении, оплатив эту услугу со счета ЛитРес. Для этого приложение отправляет запрос w_advertising_off с параметром class=2. И при успешной обработке запроса деньги списываются со счета, оффер активируется, а приложение отключает рекламу, отслеживая статус оффера через запрос r_user_offers.
ID функции
w_advertising_off
Кто может вызывать
Авторизованный пользователь
Авторизованное приложение
Принимаемые параметры
class* – номер класса оффера (целое положительное число). Допустимые значения (значения могут изменяться, уточняйте у менеджеров проектов):
- 1
- 2
- 3
Возвращаемые значения
Отсутствуют
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101045 | Offer class invalid format | Некорректный формат данных в параметре class. Допустимы только целые положительные числа от 1 до 99. |
101047 | This class is not supported | Некорректное значение в параметре class. Перечень допустимых значений см. в описании параметра или уточните у менеджера проекта. |
101048 | Insufficient funds on the account | На счёте пользователя недостаточно средств для покупки оффера. |
101049 | You already have active offer | У пользователя уже активирован запрашиваемый оффер. Имейте в виду, что осуществляя повторные покупки можно продлевать срок действия некоторых офферов. Но есть и такие классы офферов, повторная покупка которых доступна только после окончания действия купленного ранее. |
Пример запроса на сервер
{
"sid": "f121e02084344f06da1a5213999e8fcG",
"app": "1",
"time": "2015-04-22T13:49:02+03:00",
"sha": "acde0e9919a273c3a5f363eb8abe3df49fabbf768086b4ec6ecccbbc0b4d9b12",
"requests": [
{
"func": "w_advertising_off",
"id": "advertising_off",
"param": {
"class": "22"
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"advertising_off": {
"success": true
}
}