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

Параметры

HTTP метод Права доступа URL Параметры Примечание
POST manage_websites https://api.admitad.com/website/update/{id}/ Список параметров для запроса.
  • Формат данных запроса application/x-www-form-urlencoded.
  • Возвращает созданную площадку, где id - это идентификатор площадки.*
  • * Возвращает результат в формате JSON.

Список параметров для запроса.

Название Тип Обязательный Ограничения параметров Примечание, допустимые значения
name string   max length - 200  
kind string   max length - 20 Типы площадок (‘social_app’, ‘social_group’, ‘website’, ‘doorway’)
language string   max length - 2 Системные языки
adservice integer     Список рекламных сервисов (обязателен для kind = ‘social_app’, ‘social_group’)
site_url string   max length - 255  
description string  
max length - 20000
min length - 100
 
categories array of integers     Категории рекламных программ
regions array of strings     Регионы площадок
mailing_targeting bool   1 или 0 возможность таргетинга рассылок (только для E-Mail рассылок)

Пример данных для запроса

regions=RU&regions=UA&adservice=5&name=Some+other+name&language=ru&description=some+description&categories=1&categories=2&categories=3&site_url=http%3A%2F%2Fgoogle.by

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

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

curl -L -H 'Authorization: Bearer access_token' -X POST https://api.admitad.com/website/update/63/ -d 'description=some+description&site_url=http%3A%2F%2Fgoogle.by/test/'

Пример raw запроса:

POST /website/update/63/ HTTP/1.1
User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
Host: api.admitad.com
Accept: */*
Authorization: Bearer access_token

description=some+description&site_url=http%3A%2F%2Fgoogle.by/test/

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

{
    "status": "new",
    "kind": "website",
    "is_old": false,
    "name": "Some other name",
    "language": "en",
    "deleted": false,
    "creation_date": "2012-05-22 19:37:10",
    "verification_code": "4082e93ca7",
    "site_url": "http://google.by/test/",
    "regions": [
        {
            "region": "RU",
            "id": 16
        },
        {
            "region": "UA",
            "id": 17
        }
    ],
    "id": 44,
    "categories": [
        {
            "name": "Shop",
            "id": 1
        },
        {
            "name": "Online Games",
            "id": 2
        },
        {
            "name": "Browser",
            "id": 3
        }
    ],
    "description": "some description"
}

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

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