Авторизация
С чего начать? Инструменты Статистика Кошельки и вывод денег Почему не засчитался заказ? Вопрос-ответ Самозанятые Обучение
Купоны

Купоны

Получение списка купонов (Get-Coupons)

Описание
Метод для получения списка купонов.
Ссылка на метод в Swagger
Формат
https://app.epn.bz/coupons?limit=<int>&offset=<int>&isPersonal=<boolean>&viewRules=<string> 
Входные параметры
Параметры заголовка (Header Parameters)
Имя Описание Допустимые значения Обязательное
X-ACCESS-TOKEN нужно передать access token. Да
ACCEPT-LANGUAGE локаль, для которой придут купоны ru, en, es Да
Параметры запроса (Query Parameters)
Имя Описание Тип Допустимые значения Обязательное
isPersonal параметр, который вернет только эксклюзивные купоны, то есть купоны, доступные только для вашего аккаунта. boolean true false Нет
viewRules Параметр, который определяет, офферы для какого кабинета придут в ответе: офферы кабинета вебмастера или кабинета кэшбэка. string role_cashback - для получения купонов кэшбэка.
role_user - для получения купонов кабинета вебмастера
Нет (при условии, что передан access token)
typeId id типа купонов. Целочисленный идентификатор. При передаче данного параметра вернутся купоны указанного типа.
Если параметр не указывается, вернутся купоны всех типов.
int Нет
themeId id тематики купонов. Целочисленный идентификатор. При передаче данного параметра вернутся купоны указанной тематики. int Нет
offerId id оффера. Целочисленный идентификатор.При передаче данного параметра вернутся купоны указанного оффера. int Нет
limit количество элементов на странице. int Да
offset смещение int Да
Ответ
Имя Описание Обязательное
Code Код купона (промокод). Код, который нужно ввести на сайте магазина при покупке для получения скидки. Может отсутствовать, если это общая скидка. Нет
isPersonal Отметка о том, что купон является эксклюзивным, то есть добавлен только для вашего аккаунта. Нет
userId Заполняется в том случае, если купон является персональным. В таком случае в поле вернется ваш id. Нет
themeId id темы, к которой относится купон. Справочник тематик Да
offerId id оффера, к которому относится купон. Да
dateFrom начало действия купона: дата и время. Да
dateTo окончание действия купон, дата и время. Да
typeId id типа, к которому относится купон. Справочник типов купонов Да
url Страница оффера, на которую ведет купон. Да
name Название купона. Да
description Описание купона. Дополнительные условия. Описание может отсутствовать. Нет

Получение списка офферов с купонами (Get-Coupons-Offers)

Описание
Метод для получения списка офферов (магазинов), у которых есть купоны.
Ссылка на метод в Swagger
Формат
https://app.epn.bz/coupons/offers?viewRules=<string>
Входные параметры
Параметры заголовка (Header Parameters)
Имя Описание Обязательное
X-ACCESS-TOKEN нужно передать access token. Да
Параметры запроса (Query Parameters)
Имя Описание Допустимые значения Обязательное
viewRules Параметр, который определяет, офферы для какого кабинета придут в ответе: офферы кабинета вебмастера или кабинета кэшбэка. role_cashback - для получения купонов кэшбэка.
role_user - для получения купонов кабинета вебмастера
Нет (при условии, что передан access token)

Получение списка типов купонов (Get-Coupons-Types)

Описание
Метод вернет список типов купонов. Один купон может относиться только к одному типу.
Ссылка на метод в Swagger
Формат
https://app.epn.bz/coupons/types
Входные параметры
Параметры заголовка (Header Parameters)
Имя Описание Обязательное
X-ACCESS-TOKEN нужно передать access token. Да
Справочник типов купонов
Идентификатор типа (id) Название Описание типа
10 Скидка на заказ Скидка при совершении заказа от определенной суммы.
Пример:Скидка 500 р. на заказ от 5000 р
11 Подарок при заказе Подарок при совершении заказа на определенную сумму.
Пример: косметичка в подарок при заказе от 3 000 руб. в магазине Летуаль.
12 Бесплатная доставка Бесплатная доставка при выполнении определенных условий покупки.
Пример: бесплатная доставка при сумме заказа от 5 000 руб.

Получение списка тематик купонов

Описание
Метод возвращает список тематик для купонов.
Ссылка на метод в Swagger
Параметры заголовка (Header Parameters)
Имя Тип Допустимые значения Описание

ACCEPT-LANGUAGE

string ru
en
es
Язык, на котором вернется список тематик для купонов.
Справочник тематик
Идентификатор типа (id) Название
10 Черная пятница - купоны к Черной пятнице
11 Новый год - купоны на Новый год.
12 23 февраля - купоны на 23 февраля.
13 8 марта - купоны на 8 марта.
14 Киберпонедельник - купоны на Киберпонедельник
15 Скоро в школу - купоны, посвященные 1-му сентября и началу школьного года.
16 11.11 - купоны к распродаже ко Всемирному дню шоппинга 11 ноября на AliExpress
17 распродажа - общая тематика для купонов на скидки.
18 14 февраля - купоны на 14 февраля.