查询账户

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

鉴权与通用返回规则见 开放平台说明。
发版与变更记录见 开放平台发版说明。

注意事项

  1. 本接口为同步 GET，无请求 Body，调用后立即返回当前账户快照。
  2. 扣费发生在创建批改等写操作时；本接口仅查询，不扣费。
  3. balance、pro_balance 为次数型余额（小数精度与后台配置一致）；amount 为金额余额，单位为分。
  4. 普通作文批改优先扣 balance（按版本单价，如 1 次 / 1.5 次）；Pro 批改扣 pro_balance；部分场景在次数不足时会扣 amount（详见商务约定）。

请求说明

  • HTTP 方法：GET
  • 请求地址：
1
https://api.21days.cloud/opi/p/c012/account
  • URL 参数：无
  • Header：accessToken 鉴权（必填，见 开放平台说明）
  • Body：无

响应说明

字段 类型 必选 示例 解释
code Number 是 1 1=成功，0=失败；少数历史接口可能出现 -1
msg String 否 — 提示信息，成功时通常为空
data object 否 见下表 账户余额数据

data 字段说明

字段 类型 必选 示例 解释
balance Number 是 100 普通版剩余次数（用于标准版批改等，按次扣减）
pro_balance Number 是 0 Pro 版剩余次数（is_pro=1 等 Pro 批改扣减）
amount Number 是 0 账户剩余金额，单位：分（次数不足时可能作为备选扣费渠道）

示例

成功响应

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

鉴权失败

鉴权失败时可能返回 HTTP 4xx 或 HTTP 200 且 code=0，detail 结构与 开放平台说明 一致。示例：

1
2
3
4
5
6
7
8
{
  "code": 0,
  "msg": "accessToken错误或已过期",
  "detail": {
    "status_code": 403,
    "message": "accessToken错误或已过期"
  }
}

相关文档

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