ID функции
w_activate_coupon
Кто может вызывать
Авторизованный пользователь.
Авторизованное приложение.
Принимаемые параметры
code* – код купона, который пользователь пытается активировать.
Возвращаемые значения
coupone_info – информация о том, какие бонусы содержит купон. Возможны следующие элементы:
- bonus_arts – массив идентификаторов книг, которые нужно добавить пользователю;
- slonogifts – информация об активированной «раздаче слонов». Содержит:
- collection – идентификатор коллекции, из которой пользователь может взять книги;
- count – количество книг, которые пользователь может взять из указанной коллекции;
- discount – скидка на книги. Содержит:
- art_type – перечисленные через запятую типы книг, на которые распространяется скидка. См. возвращаемые значения параметра type метода r_search_arts;
- percent – процент скидки, например ;
- days – количество дней, в течение которых действует скидка. Число;
- discount_collection – скидочная коллекция;
- real_money – количество денег, добавленных на счет пользователя;
- bonus_money – количество бонусов, добавленных на счет пользователя;
- conditions – условия, которые необходимо выполнить пользователю для того, чтобы получить бонусы.
Возможные ошибки
error_code | error_message | Описание |
---|---|---|
101104 | Invalid coupone code format | Неверный формат кода купона |
101105 | This coupone already used | Этот купон уже был использован |
101106 | Redeem this coupon you can only after a deposit in the amount of one hundred rubles and above | Этот купон вы можете использовать только после пополнения счёта на сумму от ста рублей и выше |
101107 | Invalid coupon code | Неверный код купона |
101108 | This coupon has expired | Срок действия этого купона истек |
101109 | You have already activated the code in this series, the activation of the second coupon is impossible | Вы уже активировали код из этой серии купонов, активация второго купона невозможна |
101203 | Coupons limit for the campaign has been reached | Достигнут лимит купонов на кампанию |
Пример запроса на сервер
{ "sid": "f121e02084344f06da1a5213999e8fcG", "app": "1", "time": "2019-12-14T16:11:18+03:00", "sha": "b7952956569bef3c685d3453316b5c", "requests": [ { "func": "w_activate_coupon" "id": "w_activate_coupon_code" "param": { "code": "ЛИТРЕС" } }, ] ); }
Пример ответа сервера
{ "success" : true, "time" : "2019-12-14T16:11:18+03:00", "w_activate_coupon_code" : { "coupone_info" : { "discount" : { "art_type" : "0,1,4", "days" : 30, "percent" : "0.10", "type" : "discount" } "slonogifts" : [ { "collection" : "4658", "count" : 1 } ] }, "success" : true } }
Пример ответа сервера с ошибкой
{ "success" : true, "time" : "2019-12-14T16:21:38+03:00", "w_activate_coupon_code" : { "success" : false, "error_message" : "This coupon has expired", "error_code" : 101108, "time" : "2019-12-14T16:21:38+03:00" } }