ID функции
r_subscriptions_prices
Кто может вызывать
Любой пользователь.
Авторизованное приложение.
Принимаемые параметры
country – трехбуквенное обозначение страны нужной локали(сейчас действуют только RUS - рублевые цены для всех, кроме Польши и POL- для польских цен, по умолчанию используется RUS);
campaign – id кампании подписной модели (на данный момент 11 - абонемент, 14 - литрес подписка), обязательный параметр;
Возвращаемые значения
class* – массив, содержащий информацию о запрошенных ценах.
- id – индекс класса кампании (`offer_classes`.id)
- price - стоимость покупки без скидки по купону
- base_price - базовая стоимость (стоимость 1 месячного тарифа умноженная на число месяцев)
- special_price - стоимость с учетом скидки по купону или промо-цены
- next_price - стоимость продления тарифа
- price_per_month - стоимость в месяц, исходя из расчета конечной цены на 1 месяц действия подписки
- max_price - максимальная стоимость книги, которую можно взять по абонементу
- best_price - булевый атрибут, указывающий, что данный тариф является наиболее выгодным
- discount - дисконт на книги, который будет выдаваться при покупке класса абонемента
- pay_count - счетчик оплат класса (нужен для расчета времени перехода на новый класс с большей скидкой)
- profit_account - валюта счета, на который служит для расчета выгоды от покупки подписки
- arts_category - подборка книг абонемента, с которой пользователь получает 2 бесплатные книги в месяц
- arts_category_amount - сколько книг из подборки пользователь получает каждый месяц действия абонемента
- any/text/audio - количество книг из платного каталога, которые пользователь получает в месяц подписки абонемента
- discount_value - размер скидки от базовой цены в процентах
- discount_type - тип дисконта (price - конечная цена/discount - относительная скидка, пусто - промо цена)
- month - количество месяцев получаемых при покупке тарифа с учетом купонов
- country - локаль (страна) тарифа, служит для отделения польских цен абонемента от русских
- currency - валюта локали
- preffered - служебный атрибут для перехода на новые классы (в выдаче роли не играет)
- promo_price - промо стоимость указанная в классе
- promo_counter - каунтер оплат по промо цене, считается с момента первой покупки, т.е. при значении 2, мы покупаем за промо стоимость и 1 раз продлеваем за нее же.
- inapp_name - имя инаппа соответствующее классу кампании, определяется полем inapp_names.adv_campaign. Возможны варианты: если включен мод debug_on - выбирается имя инаппа с полем inapp_names.test = 1, иначе inapp_names.test = 0. (Для режима отладки)
- fornewbie - передается, если спец цена предложена по купону, у которого выставлена настройка "Только для новичков"
- is_available_trial - показывает доступен ли триал подписки для IOS
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101019 | Invalid 'campaign' param, expected campaign's number (id), or 'UserCountry' param, expecting 3 letter country code | Параметр campaign должен быть инт (11 или 14), а параметр country - 3 символа кода страны (большими буквами RUS или POL, по умолчанию RUS) |
Пример запроса на сервер
Catalit request:
{
"time" : "2023-02-28T15:11:59+03:00",
"sha" : "6df7cf13525863136c06b60c92a4c279adebd44af50a51adc01f2bf38ccbb84b",
"requests" : [
{
"param" : {
"campaign" : "11",
"country" : "RUS"
},
"func" : "r_subscriptions_prices",
"id" : "r_subscriptions_prices"
}
],
"sid" : "662r37fpft9oc9dibaemdo95c51128bg",
"mobile_app" : 1
}
Пример ответа сервера
Result:
{
"r_subscriptions_prices" : {
"class" : [
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 399,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : 0,
"id" : "37",
"max_price" : "700",
"month" : "1",
"next_price" : "399",
"pay_count" : "1",
"preferred" : "1",
"price" : "399",
"price_per_month" : "399.00",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 4788,
"best_price" : 1,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : "0.25",
"id" : "46",
"max_price" : "700",
"month" : "12",
"next_price" : "3590",
"pay_count" : "1",
"price" : "3590",
"price_per_month" : "299.17",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 1197,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : "0.17",
"id" : "40",
"max_price" : "700",
"month" : "3",
"next_price" : "999",
"pay_count" : "1",
"price" : "999",
"price_per_month" : "333.00",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 2394,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : "0.21",
"id" : "43",
"max_price" : "700",
"month" : "6",
"next_price" : "1890",
"pay_count" : "1",
"price" : "1890",
"price_per_month" : "315.00",
"profit_account" : "124"
}
],
"success" : true
},
"success" : true,
"time" : "2023-02-28T15:12:03+03:00"
}
Пример ответа с купоном
Result:
{
"r_subscriptions_prices" : {
"class" : [
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 399,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_type" : "price",
"discount_value" : "0.75",
"id" : "37",
"max_price" : "700",
"month" : "1",
"next_price" : "399",
"pay_count" : "1",
"preferred" : "1",
"price" : "399",
"price_per_month" : "99.00",
"profit_account" : "124",
"special_price" : 99
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 4788,
"best_price" : 1,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : 0.99,
"id" : "46",
"max_price" : "700",
"month" : "12",
"next_price" : "3590",
"pay_count" : "1",
"price" : "3590",
"price_per_month" : "0.08",
"profit_account" : "124",
"promo_counter" : "1",
"promo_price" : "1",
"special_price" : "1"
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 1197,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : "0.17",
"id" : "40",
"max_price" : "700",
"month" : "3",
"next_price" : "999",
"pay_count" : "1",
"price" : "999",
"price_per_month" : "333.00",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "100111",
"arts_category_amount" : "2",
"base_price" : 2394,
"country" : "RU",
"currency" : "RUB",
"discount" : "0.1",
"discount_value" : "0.21",
"id" : "43",
"max_price" : "700",
"month" : "6",
"next_price" : "1890",
"pay_count" : "1",
"price" : "1890",
"price_per_month" : "315.00",
"profit_account" : "124"
}
],
"success" : true
},
"success" : true,
"time" : "2023-02-28T16:48:39+03:00"
}
Пример ответа Польша Абонемент
Result:
{
"r_subscriptions_prices" : {
"class" : [
{
"any" : "1",
"arts_category" : "154058",
"arts_category_amount" : "2",
"base_price" : 419.88,
"best_price" : 1,
"country" : "PL",
"currency" : "PLN",
"discount" : "0.1",
"discount_value" : "0.20",
"id" : "34",
"max_price" : "49.99",
"month" : "12",
"next_price" : "334.99",
"pay_count" : "1",
"preferred" : "1",
"price" : "334.99",
"price_per_month" : "27.92",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "154058",
"arts_category_amount" : "2",
"base_price" : 104.97,
"country" : "PL",
"currency" : "PLN",
"discount" : "0.1",
"discount_value" : "0.10",
"id" : "28",
"max_price" : "49.99",
"month" : "3",
"next_price" : "94.99",
"pay_count" : "1",
"preferred" : "1",
"price" : "94.99",
"price_per_month" : "31.66",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "154058",
"arts_category_amount" : "2",
"base_price" : 34.99,
"country" : "PL",
"currency" : "PLN",
"discount" : "0.1",
"discount_value" : 0,
"id" : "25",
"max_price" : "49.99",
"month" : "1",
"next_price" : "34.99",
"pay_count" : "1",
"preferred" : "1",
"price" : "34.99",
"price_per_month" : "34.99",
"profit_account" : "124"
},
{
"any" : "1",
"arts_category" : "154058",
"arts_category_amount" : "2",
"base_price" : 209.94,
"country" : "PL",
"currency" : "PLN",
"discount" : "0.1",
"discount_value" : "0.14",
"id" : "31",
"max_price" : "49.99",
"month" : "6",
"next_price" : "179.99",
"pay_count" : "1",
"preferred" : "1",
"price" : "179.99",
"price_per_month" : "30.00",
"profit_account" : "124"
}
],
"success" : true
},
"success" : true,
"time" : "2023-02-28T12:39:10+03:00"
}