◢Wakeup

开发者接口

付费创建规则，凭 token 管理后续生命周期。

POST /rules 走 x402 付费，成功后下发 365 天有效的 accessToken；后续查询、修改、停用都凭 token 操作。规则一旦真实触发即自动归档，避免重复扣费。

身份模型：没有账号，钱包地址就是身份。x402 付款里的 payer 自动成为 owner。

Token：同一 payer 反复创建规则会返回相同 token；365 天后过期。

触发即销毁：规则被真实触发并落事件后状态置为 consumed，不再轮询、不再计费。

想白嫖防御：PATCH 只允许改 name、status、actions、轮询间隔；改 type / target / condition 必须重新付费创建。

curl -X POST http://localhost:3000/api/v1/rules \
  -H "Content-Type: application/json" \
  -H "x-payer-address: 0xYourPayerWallet" \
  -d '{
    "name": "USDC 余额低于 1000",
    "type": "wallet_balance",
    "target": {
      "chain": "ethereum",
      "walletAddress": "0x...",
      "tokenSymbol": "USDC"
    },
    "condition": { "metric": "balance", "operator": "below", "value": 1000 },
    "actions": [{ "type": "phone_call", "phone": "+10000000000" }]
  }'

# 响应中 accessToken 是后续所有规则管理操作的凭证，请妥善保存。

鉴权调用

保存好 accessToken，用作 Bearer。

curl http://localhost:3000/api/v1/rules \
  -H "Authorization: Bearer wkp_..."  # POST /rules 返回的 accessToken
# token 丢了？花一笔极小额费用证明钱包所有权，
# 拿到新 token，旧 token 立刻作废，同时返回全部历史规则。
curl -X POST http://localhost:3000/api/v1/login \
  -H "x-payer-address: 0xYourPayerWallet"

接口列表

当前开放的 API。

GET/api/v1/health检查数据库和 Redis 连接。公开
POST/api/v1/rules创建一条监控规则；触发一次后自动归档。x402 付费
POST/api/v1/login极小额付费换回 token + 拉取全部历史规则。x402 付费
GET/api/v1/rules列出当前钱包名下全部规则。Bearer Token
GET/api/v1/rules/:id查看单条规则详情。Bearer Token
PATCH/api/v1/rules/:id修改 name / status / actions / 轮询间隔。Bearer Token
DELETE/api/v1/rules/:id删除规则。Bearer Token
POST/api/v1/rules/:id/test立即评估一条规则；真实投递时同样消耗规则。Bearer Token
GET/api/v1/events查看当前钱包名下规则的触发事件和电话投递记录。Bearer Token