账户余额查询
用 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
拿到 API Key
登录控制台 → API Key → 创建或复制。长得像 sk_live_ 开头。不要发给别人,不要写进网页前端或公开仓库。
- 2
发一个 GET
地址固定:https://v1.apizero.cn/api/user-info 。没有城市、条码这类查询参数。请求头写 Authorization: Bearer 你的Key。
- 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 的公开编号和后四位,不是完整密钥