Как узнать баланс через API

Баланс можно получить в любой момент, не заходя в личный кабинет. Это удобно для скриптов, которые работают долго: можно проверить остаток перед большой партией задач или остановить работу и прислать себе уведомление, когда деньги заканчиваются.

Запрос

Отправьте GET-запрос на res.php с двумя параметрами:

• action: всегда getbalance
• key: ваш API-ключ

Адрес зависит от того, где находится ваш сервер:

Где сервер	Адрес
Россия	http://api.cap.guru/res.php
Другие страны	http://api2.cap.guru/res.php

http://api.cap.guru/res.php?action=getbalance&key=YOUR_APIKEY

В ответ придёт текущий баланс.

Примеры

cURL:

curl "http://api.cap.guru/res.php?action=getbalance&key=YOUR_APIKEY"

Python:

import requests

r = requests.get(
    "http://api.cap.guru/res.php",
    params={"action": "getbalance", "key": "YOUR_APIKEY"},
    timeout=30,
)
print("Баланс:", r.text)

Если ключ указан неверно, вместо баланса придёт код ошибки. Что он означает, можно посмотреть на странице коды ошибок.