Примеры Postman

Обзор

Это руководство содержит пошаговые инструкции по аутентификации и созданию кампаний через API ExoClick с использованием Postman. Все примеры указывают требуемый тип запроса, заголовки и формат тела для каждого конечного пункта.

Аутентификация (вход)

Вы можете аутентифицироваться, используя учетные данные своей учетной записи или постоянный API-токен. В обоих случаях возвращается временный Bearer-токен, используемый для всех последующих запросов.

Вход с именем пользователя и паролем

Тип запроса: POST URL: https://api.exoclick.com/v2/login

Заголовки:

Content-Type: application/json

Тело (raw JSON):

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

Вход с API-токеном

Процесс создания баннерной кампании 300x250

Выполняйте эти шаги строго по порядку. Обратите внимание на переход с JSON на Form-Data на финальных шагах.

1

Создать URL целевой страницы (Библиотека)

Регистрирует URL вашего назначения. Для стандартных баннеров требуется id_library_url.

Тип запроса: POST URL: https://api.exoclick.com/v2/library/url

Заголовки:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Тело (raw JSON):

{
  "url": "https://your-landing-page.com"
}

Результат: Сохраните возвращённый "id" (например, 6512406).

2

Загрузить изображение (Библиотека)

Регистрирует ваш рекламный креатив. Изображение должно быть точно 300x250.

Тип запроса: POST URL: https://api.exoclick.com/v2/library/file

Заголовки:

Authorization: Bearer YOUR_TOKEN

Тело (form-data):

Ключ	Тип	Значение
file	Файл	Выберите файл изображения (300x250)
type	Текст	image

Результат: Сохраните возвращённый "id" (например, 6884966).

3

Создать каркас кампании

Задает таргетинг, бюджет и img_banner шаблон.

Тип запроса: POST URL: https://api.exoclick.com/v2/campaigns

Заголовки:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Тело (raw JSON):

{
  "name": "Banner 300x250 Production",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": {
    "type": "targeted",
    "elements": [97, 98, 99]
  },
  "countries": {
    "type": "targeted",
    "elements": [
      {
        "country": "USA",
        "regions": [0]
      }
    ]
  },
  "pricing": {
    "model": 4,
    "price": 300
  },
  "start_date": "2026-03-02",
  "daily_limit_type": 1,
  "max_daily_budget": 2000,
  "budget_delivery_mode": 1,
  "run_on_responsive_zones": 1
}

Результат: Сохраните возвращённый "id" (например, 8140060).

4

Добавить вариацию

Связывает URL (Шаг 1) и изображение (Шаг 2) с кампанией (Шаг 3).

Тип запроса: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Замените 8140060 на фактический ID вашей кампании из Шага 3)

Заголовки:

Authorization: Bearer YOUR_TOKEN

Тело (form-data):

Ключ	Тип	Значение
id_library_url	Текст	6512406 (из Шага 1)
id_library_file	Текст	6884966 (из Шага 2)
active	Текст	1

Все идентификаторы, возвращаемые на каждом шаге, необходимо сохранять и использовать в последующих запросах. Не забудьте заменить YOUR_TOKEN, пути к файлам и идентификаторы на ваши реальные значения.