Текущий баланс

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

GET https://api.yougpu.ru/billing/balance

Заголовки (Headers)

Заголовок	Значение	Описание
X-API-KEY	<YOUR_API_KEY>	Ваш API ключ
Content-Type	application/json	Формат данных

Примеры кода

curl -X GET "https://api.yougpu.ru/billing/balance" \
  -H "X-API-KEY: <YOUR_API_KEY>"

import requests

url = "https://api.yougpu.ru/billing/balance"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://api.yougpu.ru/billing/balance', {
  "method": "GET",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>"
  }
});
const data = await response.json();
console.log(data);

Ответ

200 OK

{
  "status": "success",
  "code": 200,
  "data": {
    "available": "120.50",
    "hourly_rate": "30.00",
    "pending": "30.00",
    "total": "150.50"
  }
}

Структура ответа

Параметр

Тип

Описание

status

string

Статус выполнения запроса (например, success).

code

number

HTTP код ответа.

data

object

Данные ответа:

available

string

Эффективный баланс (total − pending). Сколько можно потратить с учётом уже накопленного, но ещё не списанного долга активных ресурсов.

hourly_rate

string

Суммарный часовой тариф всех активных ресурсов (инстансы + диски).

pending

string

Накопленный долг работающих ресурсов с момента последнего часового списания. Каждый час pending обнуляется charge-транзакцией.

total

string

Текущий баланс кошелька в БД (без учёта pending).

Есть вопросы?

Поддержка Чат

Нашли ошибку? Сообщить