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

Параметры

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 Ссылка на сайт рекламного сервиса