Баланс
Как проверить остаток на счету через API.
Баланс отдают два эндпоинта. Отличаются они только тем, где передаётся ключ.
Ключ в адресе
GET
https://api.capsola.cloud/getbalance?key=API_KEYОтвечает одним числом с двумя знаками после запятой — без обёртки, чтобы значение можно было подставить сразу.
text
20.00
С параметром json=1 тот же баланс приходит в JSON:
GET
https://api.capsola.cloud/getbalance?key=API_KEY&json=1json
{
"status": 1,
"response": 100
}
Ключ в заголовке
GET
https://api.capsola.cloud/balanceПринимает GET и POST, тело не нужно. Ключ передаётся в заголовке X-API-Key.
Ответ
json
{
"status": 1,
"response": 100
}
statusnumber1 — успешно, 0 — ошибка.
responsenumber | stringТекущий баланс в рублях или код ошибки.
При ошибке status равен 0, а код приходит в response:
json
{
"status": 0,
"response": "ERROR_KEY"
}
Примеры использования
import requests
url = "https://api.capsola.cloud/balance"
api_key = "API_KEY"
headers = {
"Content-Type": "application/json",
"X-API-Key": api_key
}
# Отправка запроса
response = requests.get(url, headers=headers)
# Обработка ответа
if response.status_code == 200:
result = response.json()
print("Баланс:", result["response"])
else:
print("Произошла ошибка:", response.json()["response"])
$url = "https://api.capsola.cloud/balance";
$api_key = "API_KEY";
$headers = array(
"Content-Type: application/json",
"X-API-Key: " . $api_key
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
echo "Ошибка Curl: " . curl_error($ch);
} else {
$result = json_decode($response, true);
if ($result["status"] === 1) {
echo "Баланс: " . $result["response"];
} else {
echo "Произошла ошибка: " . $result["response"];
}
}
curl_close($ch);
const url = "https://api.capsola.cloud/balance";
const apiKey = "API_KEY";
const headers = {
"Content-Type": "application/json",
"X-API-Key": apiKey
};
// Отправка запроса
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(result => {
if (result.status === 1) {
console.log("Баланс:", result.response);
} else {
console.log("Произошла ошибка:", result.response);
}
})
.catch(error => console.error("Ошибка:", error));