Баннеры

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

Параметры

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 Мобильный контент