Перейти к основному содержанию

примеры cURL

Обзор​

В этом руководстве представлены готовые cURL-команды для аутентификации и создания кампаний через API ExoClick. Все примеры используют стандартные форматы JSON или Form-Data в зависимости от требований конечной точки.

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

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

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

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "YOUR_USERNAME",
       "password": "YOUR_PASSWORD"
     }'

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

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

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "api_token": "YOUR_API_TOKEN"
     }'

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

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

Шаг 1: Создание URL-адреса посадочной страницы (библиотеки)​

Регистрирует URL-адрес назначения.

Формат: JSON

curl -X POST "https://api.exoclick.com/v2/library/url" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-landing-page.com"
     }'

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

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

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

Формат: Форма-Данные

curl -X POST "https://api.exoclick.com/v2/library/file" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "file=@/path/to/your/image_300x250.jpg" \
     -F "type=image"

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

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

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

Формат: JSON

curl -X POST "https://api.exoclick.com/v2/campaigns" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banner 300x250",
  "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).

Формат: Форма-Данные

curl -X POST "https://api.exoclick.com/v2/campaigns/8140060/variation" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "id_library_url=6512406" \
     -F "id_library_file=6884966" \
     -F "active=1"

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