Баланс

Как проверить остаток на счету через API.

Баланс отдают два эндпоинта. Отличаются они только тем, где передаётся ключ.

Ключ в адресе

GEThttps://api.capsola.cloud/getbalance?key=API_KEY

Отвечает одним числом с двумя знаками после запятой — без обёртки, чтобы значение можно было подставить сразу.

text
20.00

С параметром json=1 тот же баланс приходит в JSON:

GEThttps://api.capsola.cloud/getbalance?key=API_KEY&json=1
json
{
  "status": 1,
  "response": 100
}

Ключ в заголовке

GEThttps://api.capsola.cloud/balance

Принимает GET и POST, тело не нужно. Ключ передаётся в заголовке X-API-Key.

Ответ

json
{
  "status": 1,
  "response": 100
}
statusnumber

1 — успешно, 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"])