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

text

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:

text

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

Campos da resposta

Campo	Tipo	Descrição
`is_active`	boolean	Se a conta está ativa
`balance`	number	Saldo disponível
`unit`	string	Moeda dos saldos e das cotas, sempre `CNY` (yuan)
`plan_type`	string	`paygo` para cobrança por uso. Valores de planos mensais começam com `monthly_`, como `monthly_2`, `monthly_limit_5` e `monthly_gpt_5`
`daily_limit`	number	Cota diária do plano mensal
`daily_used`	number	Cota do plano mensal usada hoje
`daily_remaining`	number	Cota restante hoje em um plano mensal ativo. `0` sem um plano ativo
`plan_expires_at`	string/null	Expiração do plano (ISO 8601), `null` sem plano mensal

Exemplos de requisição

curl:

bash

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

Exemplo de resposta:

json

{
  "is_active": true,
  "balance": 80.28,
  "unit": "CNY",
  "plan_type": "paygo",
  "daily_limit": 0,
  "daily_used": 0,
  "daily_remaining": 0,
  "plan_expires_at": null
}

Python:

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

A consulta não consome cota e funciona com saldo zero. Requisições fora da cobertura do plano mensal podem ser cobradas do saldo da conta.

O HTTP 401 indica que a chave de API está ausente ou é inválida. Em caso de problemas de conexão, consulte conexão e recuperação.

Primeiros passos

Crie a conta, obtenha uma chave de API, escolha o endpoint e envie a primeira requisição para confirmar o funcionamento do I Code Easy.

Perguntas frequentes

Resolva problemas comuns de chave de API, respostas 401 e 429, variáveis do Windows, conexão dos clientes, cotas e contato com suporte.

Criar conta e obter uma API Key