Список рекламных сервисов¶

Параметры¶

HTTP метод	Права доступа	URL	Параметры	Примечание
GET	public_data	`https://api.admitad.com/adservices/`	offset limit	Возвращает список рекламных сервисов.*
GET	public_data	`https://api.admitad.com/adservices/{id}/`		Возвращает рекламный сервис, где id — это идентификатор рекламного сервиса.*
GET	public_data	`https://api.admitad.com/adservices/kind/{k_id}/`	offset limit	Возвращает список рекламных сервисов для определённого типа площадки, где k_id — это тип площадки.*
GET	public_data	`https://api.admitad.com/adservices/{id}/kind/{k_id}/`		Возвращает рекламный сервис для определённого типа площадки, где k_id — это тип площадки и id — это идентификатор сервиса.*

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

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

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

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

curl -L -H 'Authorization: Bearer access-token' -X GET https://api.admitad.com/adservices/?limit=1&offset=2

curl -L -H 'Authorization: Bearer access-token' -X GET https://api.admitad.com/adservices/12/

curl -L -H 'Authorization: Bearer access-token' -X GET https://api.admitad.com/adservices/kind/website/?limit=1&offset=2

curl -L -H 'Authorization: Bearer access-token' -X GET https://api.admitad.com/adservices/12/kind/website/

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

{
    "results": [
        {
            "url": "http://adwords.google.com/",
            "logo": "http://admitad.com/some_image.png",
            "id": 3,
            "name": "Google AdWords",
            "allowed_referrers": "google.com\r\ndoubleclick.net"
        }
    ],
    "_meta": {
        "count": 9,
        "limit": 1,
        "offset": 2
    }
}

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

Название	Описание
id	Идентификатор рекламного сервиса
name	Название рекламного сервиса
logo	Логотип рекламного сервиса
allowed_referrers	Разрешённые рефереры
url	Ссылка на сайт рекламного сервиса