Разработка (API)¶

Приём кликов (Click API)¶

Клик принимается GET-запросом на домен трекера:

https://<домен>/<alias>?sub_id_1=...&external_id=...&cost=...

Первый сегмент пути - alias или token кампании. «Голый» домен ведёт на кампанию по умолчанию. Ответ - редирект/лендинг/действие в зависимости от потока.

Методы трекинга (параметр frm): pixel (1×1 GIF без редиректа), script (JS-редирект), frame (для iframe).

Приём конверсий (Postback)¶

https://<домен>/postback?subid={click_id}&status=sale&payout=10

subid резолвится в клик (по click_id, иначе по external_id). Имена параметров настраиваемы (алиасы, см. Настройки). Ответ ok (или ok (duplicate)).

Публичный REST API (Admin API)¶

Тот же интерфейс, что использует админка (/api/v1/*), доступен по API-ключу - без логина. Ключ передаётся заголовком:

Api-Key: tm_<ключ>
# или
Authorization: Bearer tm_<ключ>

Ключ создаётся в «Настройки -> API-ключи» (только админ), показывается один раз. Ключ наследует права своего пользователя (ACL): ключ не-админа видит только свои группы и получает 403 на админских эндпоинтах.

Примеры¶

# список кампаний
curl -H "Api-Key: tm_xxx" https://<домен>/admin/api/v1/campaigns

# карточка кампании
curl -H "Api-Key: tm_xxx" https://<домен>/admin/api/v1/campaigns/42

# отчёт
curl -H "Api-Key: tm_xxx" \
  "https://<домен>/admin/api/v1/reports/clicks?group_by=country&group_by2=os&date_from=2026-07-01&date_to=2026-07-31"

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

GET/POST/PUT/DELETE /api/v1/campaigns (+ /streams, /streams/{id}/clone, /labels)
GET/POST/PUT/DELETE /api/v1/{offers|landings|domains|traffic_sources|affiliate_networks|users|groups}
GET /api/v1/reports/{clicks|conversions|clicks-log|trends} - отчёты и логи
GET/PUT /api/v1/settings - настройки
GET /api/v1/system - диагностика; GET /api/v1/audit - журнал
POST /api/v1/domains/{id}/check - ручная проверка домена
GET/POST/DELETE /api/v1/api_keys - управление ключами

Ответы - JSON. Отчёты принимают date_from/date_to (YYYY-MM-DD), group_by, group_by2, f_<измерение>=значение (фильтры).

Расширение (для разработчика продукта)¶

Новые типы фильтров/действий/редиректов добавляются в сервис traffic (пакеты filters/router); измерения отчётов - в admin (groupDims).