Баннеры

Список баннеров

Параметры

HTTP метод	Права доступа	URL	Параметры	Примечание
GET	banners	`https://api.admitad.com/banners/{c_id}/`	Список параметров для запроса	Возвращает список баннеров, где с_id — это идентификатор партнерской программы*.

* Возвращает результат в формате JSON.

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

Название	Тип	Допустимые значения
landing	integer	Лендинги
mobile_content	string	true false
uri_scheme	string	http https no
offset	integer	Параметры limit, offset
limit	integer	Параметры limit, offset

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

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

curl -L -H 'Authorization: Bearer access_token' -X GET

https://api.admitad.com/banners/340/?limit=2

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

{

        "results": [

            {

                "name": "Gmail Banner",

                "size_width": 240,

                "creation_date": "2015-03-31T19:44:00",

                "size_height": 400,

                "mobile_content": true,

                "banner_image_url": "https://cdn.admitad.com/bs/2015/03/31/2c8c9dc5173456544c82a12465aadb74.png",

                "is_flash": false,

                "type": "flash",

                "id": 703

            },

            {

                "banner_flashobj_url": "https://cdn.admitad.com/bs/2015/03/23/aaab3ffd6137de8ee93149a1da0fc131.swf",

                "name": "Gmail Banner2",

                "size_width": 728,

                "creation_date": "2015-03-31T19:44:00",

                "size_height": 90,

                "mobile_content": false,

                "banner_image_url": "https://cdn.admitad.com/bs/2015/03/31/2088d0e3e765a438d6229bc62fc56c14.png",

                "is_flash": true,

                "type": "png",

                "id": 704

            }

        ],

        "_meta": {

            "count": 5,

            "limit": 2,

            "offset": 704

        }

    }

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

Название	Описание
id	Идентификатор баннера
name	Название баннера
size_width	Ширина баннера
size_height	Высота баннера
creation_date	Время добавления баннера
is_flash	Флэш-баннер
type	Тип баннера (PNG, JPEG, GIF, link, flash)
banner_image_url	Ссылка на image-баннер
banner_flashobj_url	Ссылка на flash-баннер
mobile_content	Мобильный контент

Список баннеров для площадки

Параметры

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

* Возвращает результат в формате JSON.

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

Название	Тип	Допустимые значения
landing	integer	Лендинги
mobile_content	string	true false
uri_scheme	string	http https no
offset	integer	Параметры limit, offset
limit	integer	Параметры limit, offset

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

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

curl -L -H 'Authorization: Bearer access_token' -X GET

https://api.admitad.com/banners/340/website/30220/?limit=2

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

{

        "results": [

            {

                "name": "Gmail Banner1",

                "size_width": 240,

                "creation_date": "2015-03-31T19:44:00",

                "direct_link": "https://ad.admitad.com/g/sltaobsmtn8ad74db9a54e2e5e494f/",

                "size_height": 400,

                "banner_image_url": "https://cdn.admitad.com/bs/2015/03/31/2c8cdc5173456544c82
a12465aadb94.png",

                "html_code": "<!-- admitad.banner: sltaobsmtn8ad74db9a53e2e5e494f Heroes -->\
n<a target=\"_blank\" rel=\"nofollow\" href=\"https://ad.admitad.com/g/sltaobsmtn8ad74db9a53e2
e5e494f/?i=4\">\n    <img width=\"240\" height=\"400\" border=\"0\" src=\"https://ad.admitad.co
m/b/sltaobsmtn8ad74db9a53e2e5e494f/\" alt=\"Heroes\"/>\n</a>\n<!-- /admitad.banner -->",

                "is_flash": false,

                "mobile_content": true,

                "type": "png",

                "id": 700

            },

            {

                "banner_flashobj_url": "https://cdn.admitad.com/bs/2015/03/23/aabb3ffd6137de8
ee93149a1de0fc131.swf",

                "name": "Gmail Banner2",

                "size_width": 728,

                "creation_date": "2015-03-31T19:44:00",

                "direct_link": "https://ad.admitad.com/g/4z38td62p88ad74db9a53e2e5e494f/",

                "size_height": 90,

                "banner_image_url": "https://cdn.admitad.com/bs/2015/03/31/2088d0e3e765a438d6
229bc62fc56c34.png",

                "html_code": "<!-- admitad.banner: 4z38td62p88ad74db9a53e2e5e494f Heroes -->\n
<a target=\"_blank\" rel=\"nofollow\" href=\"https://ad.admitad.com/g/4z38td62p88ad74db9a53e2e
5e494f/?i=4\">\n    <img width=\"728\" height=\"90\" border=\"0\" src=\"https://ad.admitad.com
/b/4z38td62p88ad74db9a53e2e5e494f/\" alt=\"Heroes\"/>\n</a>\n<!-- /admitad.banner -->",

                "is_flash": true,

                "mobile_content": false,

                "type": "png",

                "id": 701

            }

        ],

        "_meta": {

            "count": 5,

            "limit": 2,

            "offset": 0

        }

    }

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

Название	Описание
id	Идентификатор баннера
name	Название баннера
size_width	Ширина баннера
size_height	Высота баннера
creation_date	Время добавления баннера
direct_link	Прямая ссылка для перехода
is_flash	Флэш-баннер
type	Тип баннера (PNG, JPEG, GIF, link, flash)
banner_image_url	Ссылка на image-баннер
banner_flashobj_url	Ссылка на flash-баннер
html_code	Код баннера для вставки на сайт веб-мастера
mobile_content	Мобильный контент