GET /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_centsint账户余额(分),用于开票/冲红按次计费
task_quotaint剩余免费开票/冲红次数
subscriptionobject当前订阅信息
subscription.plan_namestring套餐名称(如"免费试用"、"基础版")
subscription.statusstring订阅状态:active / expired
subscription.expire_atstring到期日期。续订确认到账后此日期会延长
invoice_quotaobject税局侧发票剩余额度

续订说明

当订阅即将到期时,subscription.expire_at 会反映剩余有效期。续订确认到账后,expire_at 会在当前到期日基础上延长(而非重新计算开始时间)。如果当前订阅已过期,则从确认时间开始计算。

续订订单的类型为 renew,与首次购买的 new 类型不同。详见 套餐与订单

curl 示例

curl https://your-domain.com/open/v1/zhxx \
  -H "X-API-Key: sk-live-xxxx"

← 返回接口总览