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

Параметры

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

  • ** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.

  • *** Фильтр по рекламным программам, категориям рекламных программ и категориям купонов соответственно. Например

    campaign_category=3&campaign_category=7&campaign=8, где значения - это идентификаторы фильтруемых категорий.

  • **** Порядок сортировки. Возможные значения:

    • name
    • date_start
    • date_end
    • rating

    Знак ‘-‘ перед значением означает обратный порядок. Например 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/

Пример ответа 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": "Детские товары",
                    "id": 1
                },
                {
                    "name": "Красота & здоровье",
                    "id": 2
                }
            ],
            "image": "//cdn.admitad.com/media/campaign/images/2012/06/13/1d37869cf370a26b091f726cc4b24025.jpg",
            "id": 3,
            "types": [
                {
                    "name": "Бесплатная доставка",
                    "id": 1
                },
                {
                    "name": "Платная доставка",
                    "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’)