/open/v1/zhxx
账户信息聚合查询。返回平台侧余额/套餐/配额 + 税局侧发票剩余额度。
{"balance_cents": 10000, "task_quota": 300, "subscription": {"plan_name":"免费试用","status":"active","expire_at":"2027-09-04"}, "invoice_quota": {"remaining": 200, "total": 500}}
| 字段 | 类型 | 说明 |
|---|---|---|
balance_cents | int | 账户余额(分),用于开票/冲红按次计费 |
task_quota | int | 剩余免费开票/冲红次数 |
subscription | object | 当前订阅信息 |
subscription.plan_name | string | 套餐名称(如"免费试用"、"基础版") |
subscription.status | string | 订阅状态:active / expired |
subscription.expire_at | string | 到期日期。续订确认到账后此日期会延长 |
invoice_quota | object | 税局侧发票剩余额度 |
当订阅即将到期时,subscription.expire_at 会反映剩余有效期。续订确认到账后,expire_at 会在当前到期日基础上延长(而非重新计算开始时间)。如果当前订阅已过期,则从确认时间开始计算。
续订订单的类型为 renew,与首次购买的 new 类型不同。详见 套餐与订单。
curl https://your-domain.com/open/v1/zhxx \ -H "X-API-Key: sk-live-xxxx"