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

Параметры

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 - фильтровать по регионам, подходящим площадке

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",
            "campaign": {
                "id": 8,
                "name": "Campaign3"
            },
            "name": "Coupon1",
            "short_name": "coupon",
            "date_end": "2013-07-25 23:59:59",
            "date_start": "2011-11-10 00:00:00",
            "frameset_link": "http://ad.admitad.com/coupon/292e71c4f659505879f503dd58751b/",
            "goto_link": "http://ad.admitad.com/goto/4cd0ab308859505879f503dd58751b/",
            "promocode": "PRABCABC",
            "exclusive": false,
            "discount": "20%",
            "species": "promocode",
            "categories": [
                {
                    "name": "Category name 1",
                    "id": 1
                },
                {
                    "name": "Category name 2",
                    "id": 2
                }
            ],
            "image": "//cdn.admitad.com/media/campaign/images/2012/06/13/1d37869cf370a26b091f726cc4b24025.jpg",
            "id": 3,
            "regions": [
                "KZ"
            ],
            "types": [
                {
                    "name": "Type name 1",
                    "id": 1
                },
                {
                    "name": "Type name 2",
                    "id": 3
                }
            ],
            "description": "description"
        }
    ],
    "_meta": {
        "count": 8,
        "limit": 1,
        "offset": 1
    }
}

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

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

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

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