Conta
Saldo
Retorna o saldo da carteira da conta. Nada mais mudou: o saldo é uma string em USD, como os painéis padrão esperam.
POST
https://notpanel.com/api/v3action=balance- Chave de API obrigatória
- Limite de requisições atingido
- Corpo:
application/x-www-form-urlencoded
Parâmetros
Sempre enviado
keystringObrigatório- Sua chave de API.
actionstringObrigatóriobalanceDeve ser a string literal "balance".
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=balance"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "balance",
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={
"key": "YOUR_API_KEY",
"action": "balance",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'balance',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
'ignore_errors' => true,
],
]));
print_r(json_decode($response, true));
Substitua YOUR_API_KEY pela chave da sua página de API.
{
"balance": "100.84",
"currency": "USD"
}Erros
- 401
{"error":"Invalid API key","error_code":"INVALID_KEY","retryable":false}A chave está ausente, errada ou revogada.
- 429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}Um limite de taxa foi atingido. Aguarde conforme Retry-After.
Campos da resposta
Campos da resposta
balancestring- O saldo da carteira em USD, como string com pelo menos duas casas decimais.
currencystring- Sempre
USD.
Bom saber
- O dinheiro é sempre uma string, nunca um número, para que nenhum arredondamento se infiltre. Interprete-o como decimal.
- O saldo muda quando um pedido é feito, cancelado ou reembolsado, e quando você adiciona fundos.
- Adicione fundos no painel, em
/dashboard/wallet. A API não pode movimentar dinheiro.