API초보자업데이트
잔액 조회 API
API 키로 계정 잔액과 요금제 사용량을 조회할 수 있습니다. 자체 스크립트나 모니터링 시스템에 연동하기에 적합합니다.
엔드포인트 및 인증
GET https://api.icodeeasy.cc/v1/user/balance
/v1 접두사가 없는 https://api.icodeeasy.cc/user/balance도 사용할 수 있습니다.
본인의 API 키로 인증하며, 다음 세 가지 헤더 중 하나를 사용하세요:
Authorization: Bearer <내 API 키>
X-Api-Key: <내 API 키>
x-goog-api-key: <내 API 키>
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
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 키>"
응답 예시:
{
"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 키>"},
timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(f"잔액: ¥{data['balance']:.2f} ({data['unit']})")
참고
- 잔액 단위는 중국 위안(CNY)입니다. 월정액 사용자는 주로
daily_remaining(일일 한도)을 확인하세요.balance는 일일 한도를 모두 사용한 후 차감되는 예비 잔액입니다. - 이 엔드포인트는 잔액 조회 전용입니다. 잔액이 0이어도 잔액 검사에 차단되지 않고 항상 정상적으로 응답합니다.
- 401 응답은 API 키가 없거나 유효하지 않음을 의미하며,
is_active가false이면 계정이 비활성화된 것입니다. api.icodeeasy.cc연결이 느리면 백업 도메인https://jp.icodeeasy.cc또는https://sg.icodeeasy.cc로 전환하세요.