跳转到主要内容

分析

分析端点返回已计算好的洞察,Agent 无需自己拉取并聚合记录。它们只需 read 权限,并且按币种分别统计金额——绝不做跨币种汇率换算,因此数字始终精确。

支出汇总

GET /api/v1/analytics/summary(Free 与 Premium 均可用)
  • 只有已付费的 active 订阅(isTrial: false)计入 byCurrency 和 byCategory 的经常性支出总额。活跃免费试用(isTrial: true)会记录在 counts.trials(同时属于 counts.active)中,并在到期窗口内以 "isTrial": true 出现在 upcomingRenewals,不会在首次正式扣款前虚增当前月度/年度支出。
  • 已过期的 active 非试用订阅会在计算 upcomingRenewals 与 daysUntilRenewal 前自动推进到当前计费周期;免费试用(isTrial: true)不会自动顺延。
  • 自定义周期订阅(period: "custom",customDate: "<天数>")按 amount × (365 / days) 折算年度支出,再除以 12 得到月度等效金额,与网页仪表盘和报表口径一致。
  • 金额按币种分组,不要跨币种相加。

重复检测(Premium)

GET /api/v1/analytics/duplicates
[!IMPORTANT] 需要终身高级版(Lifetime Premium)。Free 账户调用此端点会返回 403 premium_required。
返回名称规范化后相同(忽略大小写和空白)的非 cancelled 订阅分组——这通常意味着重复追踪或重复扣款。
仅按名称匹配;名称不同但功能重叠的服务不会被检出。

优化建议(Premium)

GET /api/v1/analytics/optimizations
[!IMPORTANT] 需要终身高级版(Lifetime Premium)。Free 账户调用此端点会返回 403 premium_required。
返回基于事实的候选项,不臆造折扣率:
  • monthlyToAnnual——活跃的月付订阅及其当前年化成本(yearlyAtCurrentRate = monthlyAmount × 12)。
  • aboveAverageInCurrency——月度等效成本超过同币种平均值两倍的订阅。
把这些数字呈现给用户,由用户决定;该 API 报告的是当前成本,而非谈判后的优惠。