Примеры почтальонов

Обзор

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

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

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

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

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

Заголовки:

Content-Type: application/json

Тело (необработанный JSON):

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

B - Вход в систему с помощью API-токена

Используйте этот параметр, если вы создали токен на панели управления ExoClick (Профиль > Токены API).

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

Заголовки:

Content-Type: application/json

Тело (необработанный JSON):

{
  "api_token": "YOUR_API_TOKEN"
}

поток создания баннерной кампании 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

Тело (необработанный JSON):

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

Результат: Сохраните возвращаемый идентификатор (например, `6512406``).

Шаг 2: Загрузка изображения (библиотека)

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

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

Заголовки:

Authorization: Bearer YOUR_TOKEN

Тело (форма-данные):

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

Результат: Сохраните возвращаемый идентификатор (например, `6884966``).

Шаг 3: Создайте оболочку кампании

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

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

Заголовки:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Тело (необработанный 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
}

Результат: Сохраните полученный идентификатор (например, `8140060``).

Шаг 4: Добавьте вариацию

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

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

Заголовки:

Authorization: Bearer YOUR_TOKEN

Тело (форма-данные):

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

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