Список площадок веб-мастера

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET websites https://api.admitad.com/websites/
  • offset**
  • limit**
  • status***
  • campaign_status****
Возвращает список площадок.*
GET websites https://api.admitad.com/websites/{id}/   Возвращает площадку, где id - это идентификатор площадки.*
  • * Возвращает результат в формате JSON.
  • ** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.
  • *** Фильтр по статусу площадки. Возможные значения:
    • new
    • pending
    • active
    • suspended
    • declined
  • **** Фильтр по статусу рекламных программ площадки. Возможные значения:
    • pending
    • active
    • declined
    • disabled

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

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

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

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

{
    "results": [
        {
            "status": "active",
            "kind": "social_app",
            "is_old": false,
            "name": "vkontakte.ru",
            "creation_date": "2012-02-16 16:41:37",
            "verification_code": "d2b3d05c3d",
            "site_url": "http://vkontakte.ru/app123",
            "regions": [
                {
                    "region": "RU",
                    "id": 8
                }
            ],
            "adservice": {
                "id": 5,
                "name": "VKontakte"
            },
            "id": 40,
            "categories": [
                {
                    "name": "Shop",
                    "parent": null,
                    "id": 1
                },
                {
                    "name": "Online Games",
                    "parent": null,
                    "id": 2
                },
                {
                    "name": "Other",
                    "parent": null,
                    "id": 5
                },
                {
                    "name": "Test",
                    "parent": null,
                    "id": 16
                }
            ],
            "description": "description"
        }
    ],
    "_meta": {
        "count": 11,
        "limit": 1,
        "offset": 8
    }
}

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

Название Описание
id Идентификатор площадки
name Название площадки
description Описание площадки
status Статус площадки
creation_date Дата создания площадки
site_url Сайт площадки
verification_code Код верификации
kind Типы площадок
language Системные языки
regions Регионы площадок
adservice Список рекламных сервисов
categories Категории рекламных программ