查询账户

一句话说明

查询当前合作方账户的标准版剩余次数、Pro 版剩余次数与金额余额（分），用于对账、余额预警与上线前自检。

你会得到什么

字段 含义
balance 标准版剩余次数
pro_balance Pro 版剩余次数
amount 金额余额，单位：分

本接口只查询、不扣费。扣费发生在创建批改等写操作时。

怎么调用

  • 方法：GET
  • 地址：https://api.21days.cloud/opi/p/c012/account
  • Header：accessToken（见 开放平台说明）
  • Body：无

调用后立即返回当前账户快照。

扣费怎么理解（配合各业务文档）

账户字段 常见用途
balance 标准批改、小练笔、范文等按次扣减
pro_balance 创建时传 is_pro=1 时优先从此扣
amount 次数不足时，可按金额扣减（单位分）

各接口具体单价见对应文档（如 创建作文批改、小练笔批改）。

成功响应示例

1
2
3
4
5
6
7
8
{
  "code": 1,
  "data": {
    "balance": 100,
    "pro_balance": 0,
    "amount": 0
  }
}

鉴权失败时可能返回 HTTP 4xx，或 HTTP 200 且 code=0，结构见 开放平台说明。

对接检查清单

  1. Header 是否带正确的 accessToken
  2. 是否按「分」理解 amount（例如 6 表示 0.06 元）
  3. 上线前是否已用本接口确认余额充足

关联文档

主题 文档
鉴权与返回规则 开放平台说明
创建批改（扣费入口） 创建作文批改
接口清单 接口总览索引