API de Consulta de Saldo

Consulte o saldo da sua conta e o uso do plano com sua chave de API — ideal para integrar aos seus próprios scripts ou sistemas de monitoramento.

Endpoint e autenticação

GET https://api.icodeeasy.cc/v1/user/balance

O caminho sem o prefixo /v1, https://api.icodeeasy.cc/user/balance, também funciona.

Autentique-se com sua própria chave de API usando um destes cabeçalhos:

Authorization: Bearer <sua chave de API>
X-Api-Key: <sua chave de API>
x-goog-api-key: <sua chave de API>

Campos da resposta

Exemplos de requisição

curl:

curl https://api.icodeeasy.cc/v1/user/balance \
  -H "Authorization: Bearer <sua chave de API>"

Exemplo de resposta:

{
  "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 <sua chave de API>"},
    timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(f"Saldo: ¥{data['balance']:.2f} ({data['unit']})")

Observações

• Os saldos são em yuan chinês (CNY). Usuários de plano mensal devem acompanhar principalmente o daily_remaining (cota diária); o balance é o saldo de reserva cobrado após o esgotamento da cota diária.
• Este endpoint apenas consulta o saldo. Ele sempre responde normalmente — mesmo com saldo zero — e nunca é bloqueado pela verificação de saldo.
• Uma resposta 401 significa que a chave de API está ausente ou é inválida; is_active: false significa que a conta foi desativada.
• Se o api.icodeeasy.cc estiver lento, use um domínio alternativo: https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.