监控

账户余额查询

用 API Key 查自己的余额、剩余次数和套餐到期,给监控告警用。

地址

GET /api/user-info

https://v1.apizero.cn/api/user-info

参数

没有业务参数

不要传 user_id

费用

不扣费

只读,不改账户

这个接口干什么

以前只能打开网页控制台看余额。现在可以用同一把 API Key,写个定时任务自己拉:还剩多少钱、还剩多少次、套餐哪天到期。适合余额不足提醒、用量统计,避免额度突然用完业务中断。

它只读,不会充值、扣费、改密码,也查不到别人的账户。

  • 余额:data.balance.yuan(人民币元)
  • 剩余次数:data.trial.remaining、data.plans[].remaining、预付费 Key 看 data.key.quota_remaining
  • 已消耗:data.usage.today_calls / month_calls、data.month_spent.yuan、data.trial.used
  • 到期:data.vip.expire_at、data.plans[].expire_at

小白三步

  1. 1

    拿到 API Key

    登录控制台 → API Key → 创建或复制。长得像 sk_live_ 开头。不要发给别人,不要写进网页前端或公开仓库。

  2. 2

    发一个 GET

    地址固定:https://v1.apizero.cn/api/user-info 。没有城市、条码这类查询参数。请求头写 Authorization: Bearer 你的Key。

  3. 3

    看 data 里的字段

    整段 JSON 里 code 等于 0 才成功。业务数字都在 data 里。监控告警通常只看 balance.yuan、plans[].remaining、vip.days_left。

参数和请求头

没有查询参数,也没有 POST 身体。传 user_id、email 会被忽略,不能用来查别人。

  • Authorization: Bearer sk_live_你的Key(推荐,必填二选一)
  • X-Api-Key: sk_live_你的Key(和上面等价)
  • 不要写成 ?api_key=,Key 会进网站访问日志

复制就能跑

把 YOUR_KEY 换成控制台里的 Key。建议 5 分钟查一次,不要疯狂连打。

curl -sS "https://v1.apizero.cn/api/user-info" \
  -H "Authorization: Bearer YOUR_KEY"

返回字段(看这个表)

预付费可售 Key(卖给别人用的那种)data.scope 是 key:钱包、VIP、套餐都是空,只看 key.quota_remaining。普通 Key 的 scope 是 account。

  • balance.yuan:钱包还剩多少人民币,例如 "12.3400"
  • points.remaining:还剩多少点数
  • usage.today_calls / month_calls:今天、本月一共调了多少次
  • usage.month_spent.yuan:本月钱包花了多少元
  • vip.expire_at / vip.days_left:会员哪天到期、还剩几天;没有会员则 vip 为 null
  • trial.remaining / trial.used:各接口试用次数合计
  • plans[]:生效中的包月/包年。remaining 是剩余次数,expire_at 是到期时间
  • key.id / key.last4:当前这把 Key 的公开编号和后四位,不是完整密钥

限流和注意

必须带 API Key,不支持匿名。带 Key 不限日次数,每把 Key 每秒 1 次。查太快会 429。本接口不扣钱包。只能看当前这把 Key 对应的自己,列不出账号下其它 Key,也拿不到密钥明文。