# Баннеры
# Список баннеров  <span id="list-of-banners" />

## Параметры <span id="list-of-banners-parameters" />

| HTTP метод | Права доступа                                                                                          | URL                                      | Параметры                                                                | Примечание                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| GET        | [banners](/article/ru/308#banners) | https://api.admitad.com/banners/{c\_id}/ | [Список параметров для запроса](#list-of-banners-parameter-request-list) | Возвращает список баннеров, где с\_id — это идентификатор партнерской программы\*. |

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

## Список параметров для запроса <span id="list-of-banners-parameter-request-list" />

| Название        | Тип     | Допустимые значения                                                                                                                                       |
| --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| landing         | integer | [Лендинги](/article/ru/322)                                     |
| mobile\_content | string  | true                                                                                                                                                      |
|                 |         | false                                                                                                                                                     |
| uri\_scheme     | string  | http                                                                                                                                                      |
|                 |         | https                                                                                                                                                     |
|                 |         | no                                                                                                                                                        |
| offset          | integer | [Параметры limit, offset]() |
| limit           | integer | [Параметры limit, offset]() |

## Пример использования <span id="list-of-banners-example-of-use" />

Пример запроса с использованием утилиты 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-сервера <span id="list-of-banners-description-of-api-server-response-fields" />

| Название              | Описание                                  |
| --------------------- | ----------------------------------------- |
| 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       | Мобильный контент                         |

# Список баннеров для площадки <span id="list-of-banners-for-ad-space" />

## Параметры <span id="list-of-banners-for-ad-space-parameters" />

| HTTP метод | Права доступа                                                                                                                    | URL                                                      | Параметры                                                                              | Примечание                                                                                                              |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| GET        | [banners\_for\_website](/article/ru/308#banners-for-website) | https://api.admitad.com/banners/{c\_id}/website/{w\_id}/ | [Список параметров для запроса](#list-of-banners-for-ad-space-parameters-request-list) | Возвращает список баннеров, где c\_id — это идентификатор партнерской программы и w\_id — это идентификатор площадки\*. |

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

## Список параметров для запроса <span id="list-of-banners-for-ad-space-parameters-request-list" />

| Название        | Тип     | Допустимые значения                                                                                                                                       |    |
| --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | :- |
| landing         | integer | [Лендинги](/article/ru/322)                                     |    |
| mobile\_content | string  | true                                                                                                                                                      |    |
|                 |         | false                                                                                                                                                     |    |
| uri\_scheme     | string  | http                                                                                                                                                      |    |
|                 |         | https                                                                                                                                                     |    |
|                 |         | no                                                                                                                                                        |    |
| offset          | integer | [Параметры limit, offset]() |    |
| limit           | integer | [Параметры limit, offset]() |    |

## Пример использования <span id="list-of-banners-for-ad-space-example-of-use" />

Пример запроса с использованием утилиты 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-сервера <span id="list-of-banners-for-ad-space-description-of-api-server-response-fields" />

| Название              | Описание                                    |
| --------------------- | ------------------------------------------- |
| 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       | Мобильный контент                           |