API入门读者更新于
余额查询 API
通过 API Key 查询账户余额和套餐用量，适合接入你自己的脚本或监控系统。
端点与认证
GET https://api.icodeeasy.cc/v1/user/balance
不带 /v1 前缀的 https://api.icodeeasy.cc/user/balance 同样可用。
使用你自己的 API Key 认证，以下三种请求头任选其一：
Authorization: Bearer <你的API Key>
X-Api-Key: <你的API Key>
x-goog-api-key: <你的API Key>
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
is_active | boolean | 账号是否启用 |
balance | number | 可用余额（元） |
unit | string | 币种，固定为 CNY |
plan_type | string | 套餐类型，普通按量用户为 balance，月卡用户为 monthly_limit_* |
daily_limit | number | 月卡每日额度（元），非月卡为 0 |
daily_used | number | 今日已用月卡额度（元） |
daily_remaining | number | 今日剩余月卡额度（元） |
plan_expires_at | string/null | 套餐到期时间（ISO 8601），无月卡为 null |
请求示例
curl：
curl https://api.icodeeasy.cc/v1/user/balance \
-H "Authorization: Bearer <你的API Key>"
响应示例：
{
"is_active": true,
"balance": 80.28,
"unit": "CNY",
"plan_type": "balance",
"daily_limit": 0,
"daily_used": 0,
"daily_remaining": 0,
"plan_expires_at": null
}
Python：
import requests
resp = requests.get(
"https://api.icodeeasy.cc/v1/user/balance",
headers={"Authorization": "Bearer <你的API Key>"},
timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(f"余额: ¥{data['balance']:.2f} ({data['unit']})")
说明
- 余额单位为人民币元（CNY）。月卡用户主要看
daily_remaining（每日额度），balance是每日额度用完后扣减的备用余额。 - 该接口只做余额查询，即使余额为 0 或被判定余额不足，也能正常返回，不会被余额校验拦截。
- 返回 401 表示 API Key 缺失或无效；
is_active为false表示账号已被停用。 - 如果
api.icodeeasy.cc连接慢，可以把域名换成备用接入域名https://jp.icodeeasy.cc或https://sg.icodeeasy.cc。