Купоны

Список купонов

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET coupons https://api.admitad.com/coupons/ Список параметров для запроса Возвращает список купонов веб-мастера*.
GET coupons https://api.admitad.com/coupons/{id}/   Возвращает купон для площадки, где id — это идентификатор купона*.
  • * Возвращает результат в формате JSON.

Список параметров для запроса

Название Тип Допустимые значения
campaign integer Список партнерских программ
category integer Категории купонов
campaign_category integer Категории партнерских программ
type integer  
search string Поиск по названию и описанию купона, названию партнерской программы
date_start date %d.%m.%Y
date_end date %d.%m.%Y
offset integer Параметры limit, offset
limit integer Параметры limit, offset
order_by* string
  • name
  • rating
  • date_start
  • date_end

Знак '-' перед значением означает обратный порядок. Например, order_by=-rating&order_by=date_start.

region string Регионы площадок
language string Системные языки

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
https://api.admitad.com/coupons/?region=KZ&limit=1

Пример ответа API-сервера в формате JSON:

{
"results": [
{
"status": "active",
"rating": "2.50",
"campaign": {
"id": 8,
"name": "Campaign_8",
"site_url": "http://example.com/"
},
"description": "description",
"short_name": "coupon",
"exclusive": false,
"date_end": "2018-07-25T23:59:59",
"date_start": "2018-11-10T00:00:00",
"id": 3,
"regions": [
"KZ"
],
"language": "en",
"discount": "20%",
"types": [
{
"id": 1,
"name": "Type name 1"
},
{
"id": 2,
"name": "Type name 2"
}
],
"image": "//cdn.admitad.com/media/campaign/images/2018/06/13/1d37869cf370a26b091f726cc4b24025.jpg",
"species": "promocode",
"categories": [
{
"id": 1,
"name": "Category name 1"
},
{
"id": 2,
"name": "Category name 2"
},
],
"name": "Coupon1"
}
],
"_meta": {
"count": 8,
"limit": 1,
"offset": 1
}
}

Описание полей ответа API-сервера

Название Описание
id Идентификатор купона
name Название купона
image Изображение купона
status Статус купона
rating Рейтинг купона
description Описание купона
campaign Рекламная программа купона
date_start Дата начала действия купона
date_end Дата окончания действия купона (если значение поля — null, то купон бессрочный)
categories Категории купонов
types Типы купонов
exclusive Эксклюзивный
discount Скидка для купона (необязательное поле)
species Разновидность купона('promocode', 'action')
is_personal Персональный промокод. Для отслеживания действий обязателен переход по партнерской ссылке.
is_unique

Уникальный промокод. Он не требует перехода по партнерской ссылке для отслеживания действий.

regions Регионы площадок
language Системные языки

Список купонов для площадки

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET coupons_for_website https://api.admitad.com/coupons/website/{w_id}/ Список параметров для запроса Возвращает список купонов для площадки, где w_id — это идентификатор площадки*.
GET coupons_for_website https://api.admitad.com/coupons/{c_id}/website/{w_id}/   Возвращает купон для площадки, где w_id — это идентификатор площадки и c_id — это идентификатор купона*.
  • * Возвращает результат в формате JSON.

Список параметров для запроса

Название Тип Допустимые значения
campaign integer Список партнерских программ
category integer Категории купонов
campaign_category integer Категории партнерских программ
type integer  
search string

Поиск по названию и описанию купона, названию партнерской программы

date_start date %d.%m.%Y
date_end date %d.%m.%Y
offset integer Параметры limit, offset
limit integer Параметры limit, offset
region string

Регионы площадок

99 — фильтровать по регионам, подходящим площадке

language string Системные языки
order_by * string
  • name
  • rating
  • date_start
  • date_end

Знак '-' перед значением означает обратный порядок. Например, order_by=-rating&order_by=date_start.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
https://api.admitad.com/coupons/website/22/?limit=1

curl -L -H 'Authorization: Bearer access_token' -X GET
https://api.admitad.com/coupons/1/website/22/?region=KZ

Пример ответа API-сервера в формате JSON:

{
"results": [
{
"status": "active",
"rating": "2.50",
"date_start": "2018-11-10T00:00:00",
"campaign": {
"id": 8,
"name": "Campaign_8",
"site_url": "http://example.com/"
},
"short_name": "coupon",
"exclusive": false,
"name": "Coupon1",
"date_end": "2018-07-25T23:59:59",
"promocode": "PRABCABC",
"id": 3,
"regions": [
"KZ"
],
"language": "en",
"discount": "20%",
"types": [
{
"id": 1,
"name": "Type name 1"
},
{
"id": 2,
"name": "Type name 2"
}
],
"image": "//cdn.admitad.com/media/campaign/images/2018/06/13/1d37869cf370a26b091f726cc4b24025.jpg",
"frameset_link": "http://ad.admitad.com/coupon/292e71c4f659505879f503dd58751b/",
"goto_link": "http://ad.admitad.com/goto/4cd0ab308859505879f503dd58751b/",
"species": "promocode",
"categories": [
{
"id": 1,
"name": "Category name 1"
},
{
"id": 2,
"name": "Category name 2"
},
],
"description": "description"
}
],
"_meta": {
"count": 8,
"limit": 1,
"offset": 1
}
}

Описание полей ответа API-сервера

Название Описание
id Идентификатор купона
name Название купона
image Изображение купона
status Статус купона
rating Рейтинг купона
description

Описание купонов

campaign Рекламная программа купона
date_start Дата начала действия купона
date_end Дата окончания действия купона (если значение поля — null, то купон бессрочный)
categories Категории купонов
types Типы купонов
frameset_link Ссылка на фреймсет с шапкой
goto_link Прямая ссылка для перехода
promocode Промокод
exclusive Эксклюзивный
is_personal

Уникальный промокод. Он не требует перехода по партнерской ссылке для отслеживания действий.

is_unique Персональный промокод. Для отслеживания действий обязателен переход по партнерской ссылке.
discount Скидка для купона (необязательное поле)
species Разновидность купона ('promocode', 'action')
regions Регионы площадок
language Системные языки

Категории купонов

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET public_data https://api.admitad.com/coupons/categories/
  • limit**
  • offset**
Возвращает категории купонов*.
GET public_data https://api.admitad.com/coupons/categories/{id}/   Возвращает категорию купонов, где id — это идентификатор категории*.
  • * Возвращает результат в формате JSON.
  • ** Задаёт пропуск и количество возвращаемых записей. Например, limit=5&offset=2.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET
https://api.admitad.com/coupons/categories/?limit=2

Пример ответа API-сервера в формате JSON:

{
"results": [
{
"name": "Category name 1",
"id": 1
},
{
"name": "Category name 2",
"id": 2
}
],
"_meta": {
"count": 10,
"limit": 2,
"offset": 0
}
}

Описание полей ответа API-сервера

Название Описание
id Идентификатор категории купона
name Название категории купона