X-STATS 网站统计服务

产品简介

X-STATS 提供轻量、无 Cookie 的访问统计能力，专注于 URL 级 PV、来源域名与趋势分析，帮助团队快速搭建隐私友好的数据面板。

快速体验

在 XAPI 控制台生成 pk- 公钥，将其嵌入前端或脚本中。
调用 POST /x-urls/{pk-...}/track 上报访问事件，可在 Referer 头中携带来源。
通过 GET /x-urls/{pk-...}/overview 查看总览数据，或用 top、referers 获取排行榜。
如果需要清空历史数据，管理员可携带 sk- 密钥请求 POST /x-urls/clear。

核心能力

零 Cookie 依赖：仅记录 URL 与来源域名，不触碰用户隐私。
实时聚合：Redis + 事件总线架构确保高并发实时写入与查询。
榜单洞察：内置 Top URL、Top Referer 榜单，支持自定义条数。
数据复位：支持管理接口按账户清空统计，便于运营重启。

API 参考

方法	路径	说明
`POST`	`/x-urls/{pk-...}/track`	上报一次访问，可在 JSON 或请求头中附带 `url` 与 `referer`
`GET`	`/x-urls/{pk-...}/overview`	获取总览（访问次数、来源数量等）
`GET`	`/x-urls/{pk-...}/stats?url=`	查询指定 URL 的详细统计
`GET`	`/x-urls/{pk-...}/top?limit=10`	获取访问量 Top N URL
`GET`	`/x-urls/{pk-...}/referers?limit=10`	获取来源域名 Top N
`POST`	`/x-urls/clear`	清空当前账户的统计数据（需 `sk-` 私钥）

示例：追踪一次页面访问

export XAPI_PUBLIC_KEY="你的-公共-密钥" # pk- 开头

curl -X POST "https://api.xabcstack.com/x-urls/${XAPI_PUBLIC_KEY}/track" \
  -H "Content-Type: application/json" \
  -H "Referer: https://www.google.com/" \
  -d '{
      "url": "https://blog.yoursite.com/articles/totp-security"
    }'

常见问题

是否支持后端埋点？ 支持，通过 POST /track 在服务器侧调用即可。
如何限制上报频率？ 可在前端加本地节流，平台会自动聚合重复访问。
能否自建面板？ 所有接口均为 REST JSON，可直接接入自定义仪表盘或 BI 系统。