Серверные переходы

Когда это нужно

Когда нельзя поставить код на страницу или вы хотите, чтобы ваш сервер решал, что считается посещением. Сервер сообщает о посещении и получает подписанный переход, который нужно сохранить.

Вызов

POST https://go.hitctrl.com/hits
x-api-key: your API key

{
  "link": "lp_7Kq2",
  "source": "jane-doe",
  "subIds": { "s1": "summer", "s2": "banner-a" },
  "ip": "203.0.113.7",
  "userAgent": "Mozilla/5.0 …",
  "referrer": "https://news.example/"
}

• link: ID посадочной страницы (linkId ссылки); source: ID партнёра (sourceId ссылки); subIds: sub ID s1–s5 (affS1–affS5 ссылки).
• ip и userAgent: данные посетителя, чтобы боты и лимиты проверялись так же, как для кода.
• Необязательные country, region и city, если сервер уже их знает; иначе они берутся из IP-адреса.

link, ip и userAgent обязательны. Не указывайте source для собственных ссылок команды: они засчитываются рабочему пространству, без партнёра.

Ответ содержит подписанный hit (и expiresAt — когда он перестанет засчитываться), который нужно позже отправить с конверсией. Пропущенные поля дают missing_params; неверный IP-адрес — invalid_ip_address.

Полезно знать

• Действуют те же проверки, что и для кода: партнёр, посадочная страница, оффер, доступ, боты и лимиты.
• Используйте API-ключ из Настройки › Разработчикам. Если у ключа есть список разрешённых IP, вызывать могут только эти адреса.