api v3 · для агентств и разработчиков

HTTP API

Программный доступ к запуску кампаний, аналитике и медиа-сессиям. Все эндпоинты — под https://wwcdn.hiluxmedia.xyz/api/v3/. Аутентификация — Bearer-токен из кабинета.

Быстрый старт

Запустить кампанию продвижения — один POST:

# создать кампанию — 100К просмотров на YouTube-ролике
curl -X POST https://wwcdn.hiluxmedia.xyz/api/v3/campaigns \
  -H "Authorization: Bearer $HILUX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=…",
    "target": { "views": 100000, "retention_min": 0.55 },
    "audience": { "geo": ["RU","BY"], "age": "18-35", "interests": ["edtech"] }
  }'

# → {"id":"7842","status":"queued","estimate":"36h","cost_rub":1140000}

Основные эндпоинты

Метод	Путь	Назначение
`POST`	`/api/v3/campaigns`	Создать кампанию продвижения
`GET`	`/api/v3/campaigns/{id}`	Статус и статистика кампании
`POST`	`/api/v3/campaigns/{id}/pause`	Приостановить открутку
`GET`	`/api/v3/media/session/{id}`	Медиа-сессия партнёра для проигрывания
`GET`	`/api/v3/audiences`	Список сохранённых аудиторий
`GET`	`/api/v3/analytics/{campaign_id}`	Просмотры, ретеншн, гео по часам
`GET`	`/api/v3/wallet`	Баланс и история списаний

Webhooks

Регистрируется через POST /api/v3/webhooks. Подпись — HMAC-SHA256 в заголовке X-Hilux-Signature. Retries — 5 попыток экспоненциально до 30 мин.

// пример payload
{
  "event": "view.completed",
  "campaign_id": "7842",
  "session_id": "pullet_9f3a2b7c",
  "platform": "youtube",
  "geo": "RU-MOW",
  "retention": 0.68,
  "cost_rub": 11.4,
  "at": "2026-07-24T21:14:03Z"
}

События: view.completed, subscription.made, subscription.dropped, comment.posted, campaign.paused, campaign.finished, wallet.low_balance.

Нужен пример на вашем стеке?

Есть готовые обёртки для Node.js, Python и PHP — напишите, вышлем ссылку.