Skip to main content
l402kit.com/dashboard 上的分析仪表板可实时显示流经您 API 的所有支付统计数据：收到的总 sats 数、各端点明细、7 天趋势以及最近的交易记录。

​
设置

仪表板由密钥令牌 DASHBOARD_SECRET 保护。您只需生成一次，并将其存储在与其他密钥相同的地方。

​
1. 生成密钥

openssl rand -hex 32
# → shdp_dash_a1b2c3d4e5f6...
或使用任意密码管理器生成一个强随机字符串。

​
2. 在您的 provider 中设置

Cloudflare Workers： 
cd cloudflare/
wrangler secret put DASHBOARD_SECRET
# 在提示时粘贴您的密钥
Node.js / 其他： 
# .env
DASHBOARD_SECRET=shdp_dash_a1b2c3d4e5f6...

​
3. 登录

前往 l402kit.com/dashboard，输入您的密钥即可进入。无需邮箱、无需 OAuth、无需 Cookie — 密钥以 x-dashboard-secret 的形式随每次统计请求发送。

​
可查看的内容

指标说明
总支付次数已验证的 L402 支付的历史总计数
总 sats所有支付的 amount_sats 之和
7 天趋势当前 7 天与前 7 天窗口的支付次数及 sats 对比
按端点各路由收益明细
最近 20 条最新支付记录，包含哈希、端点、金额、时间戳

​
API

相同的数据可直接通过 API 获取 — 适用于构建您自己的仪表板或接入 Grafana。 
curl https://l402kit.com/api/stats \
  -H "x-dashboard-secret: YOUR_SECRET"

{
  "totalPayments": 142,
  "totalSats": 14200,
  "shinydappsFee": 42,
  "trend": {
    "payments7d": 38,
    "payments7dPrev": 21,
    "sats7d": 3800,
    "sats7dPrev": 2100
  },
  "byOwner": {
    "you@blink.sv": { "count": 142, "sats": 14200 }
  },
  "recent": [...]
}

​
安全模型

  • 密钥永远不会离开您的环境 — 它在 Cloudflare Worker 中使用严格相等进行服务端比较
  • 不会签发会话令牌 — 每次请求都会重新验证密钥
  • 密钥仅有只读权限 — 只能调用 /api/stats，不能写入或删除数据
  • 随时可通过 wrangler secret put 更新 DASHBOARD_SECRET 来生成新密钥
切勿将 DASHBOARD_SECRET 提交到 git。请将其添加到您的 .gitignore，并使用 wrangler secret put 或您的 CI/CD 密钥管理器进行管理。

​
轮换密钥

# 生成新密钥
openssl rand -hex 32

# 在 Cloudflare Workers 中更新
wrangler secret put DASHBOARD_SECRET

# 完成 — 旧密钥立即失效
无需更新任何数据库条目。Worker 在每次请求时从环境中读取密钥。