服务器端访问

何时使用

当您无法在页面上放置代码，或希望由您的服务器决定什么算作一次访问时。服务器上报访问，并获得一个需要保存的签名访问。

调用

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：子 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 允许列表，只有这些地址可以调用。