统计、Campaign 与 Tag 接口

统计数据按工作区隔离，可进一步按短链、Campaign、Tag、高级路由、终端和时间过滤。

点击明细与分析

方法	路径	说明
GET	/api/v1/click_statistics	分页点击明细
GET	/api/v1/click_statistics/analysis	汇总分析
GET	/api/v1/click_statistics/geo-analysis	国家/省份/城市地域聚合
GET	/api/v1/click_statistics/export	下载 UTF-8 CSV

常用 Query：

page=1&page_size=50
short_link_id=42&campaign_id=12&tag_id=3&route_id=7
device_type=mobile&is_bot=false
country=中国&province=安徽省&city=合肥市
start_date=2026-07-01&end_date=2026-07-21

start_date 和 end_date 使用 YYYY-MM-DD；分析接口指定日期范围时必须同时提供两者，否则可以使用 days=7，范围 1–365。地域接口用 level=country|province|city，下钻时再提供上级地区。

CSV 端点返回文件流，不是统一 JSON。客户端应检查 Content-Type: text/csv 和 Content-Disposition。

工作台统计

方法	路径
GET	/api/v1/statistics/system
GET	/api/v1/statistics/dashboard
GET	/api/v1/statistics/short-links

这些接口用于管理端 KPI、趋势和短链排行。精细筛选和导出应使用 click_statistics。

Campaign

方法	路径
POST/GET	/api/v1/campaigns
GET/PUT/DELETE	/api/v1/campaigns/:id
GET	/api/v1/reports/campaigns

{
  "name": "2026 夏季发布",
  "description": "邮件和社媒联合投放",
  "start_at": "2026-07-01T00:00:00+08:00",
  "end_at": "2026-08-01T00:00:00+08:00",
  "status": "active"
}

状态为 active 或 archived。活动报表返回关联短链数、点击数和独立 IP。

Tag

方法	路径
POST/GET	/api/v1/tags
GET/PUT/DELETE	/api/v1/tags/:id

Tag 在工作区内用于分类和筛选；创建短链时通过 tag_ids 关联。Campaign 是单选归因实体，Tag 是多选标签，不应混用。

隐私与留存

点击明细包含 IP、User-Agent、Referer、Query 和地理信息。部署方应根据适用法律确定告知、访问控制、保存期限、脱敏和删除策略。当前版本不提供自动归档任务，需由运维在数据库层制定留存方案。

相关章节：短链接接口、A/B 测试。