Selectel API: Следить за балансом и прогнозом расходов

Сценарий из mcp-everything. Актуально на 2026-10-24.

Не допустить отключения серверов из-за нулевого баланса.

Запроси балансы: GET /v3/balances — в data.billings для каждого вида биллинга итоговая сумма final_sum и долг debt_sum.
Запроси прогноз: GET /v2/billing/prediction — на сколько часов хватит остатка по облаку, хранилищу и другим услугам.
Для этих методов подходит статический токен (заголовок X-Token) или IAM-токен аккаунта. Проверяй по расписанию и шли себе предупреждение, когда прогноз меньше пары суток.

curl https://api.selectel.ru/v3/balances -H "X-Token: $SELECTEL_STATIC_TOKEN"
curl https://api.selectel.ru/v2/billing/prediction -H "X-Token: $SELECTEL_STATIC_TOKEN"

Базовые URL

Боевой: https://api.selectel.ru
Identity (токены): https://cloud.api.selcloud.ru
Адреса по сервисам: https://api.selectel.ru/vpc/resell/v2

Авторизация

Тип: Другое

IAM-токен аккаунта (iam_token_account_scoped) или проекта (iam_token_project_scoped) — заголовок X-Auth-Token, живёт 24 часа. Получается запросом POST https://cloud.api.selcloud.ru/identity/v3/auth/tokens (метод password: имя сервисного пользователя, ID аккаунта как домен, пароль; scope — domain или project). Токен возвращается в заголовке ответа X-Subject-Token, код 201.
Статический токен (static_token) — заголовок X-Token, без срока действия, только для пользователей панели; не работает с OpenStack API. Нужен для отчётов биллинга, тикетов, учёта IP.

Для рабочих интеграций документация рекомендует сервисных пользователей.

Методы сценария

GET /v3/balances — Балансы аккаунта

В ответе data.settings (mode, currency), data.billings[] (billing_type, final_sum, debt_sum, balances[]), data.debt_status.

Параметр	Где	Тип	Обяз.	Описание
`X-Token`	header	string	да	Статический токен или IAM-токен аккаунта (X-Auth-Token)

GET /v2/billing/prediction — Прогноз баланса

Сколько часов хватит остатка: data.primary, data.storage, data.vmware, data.vpc.

Параметр	Где	Тип	Обяз.	Описание
`X-Token`	header	string	да	Статический токен или IAM-токен аккаунта

Нюансы

Облачные серверы, сети и диски создаются через OpenStack API; Resell API управляет проектами, квотами, публичными IP, подсетями и трафиком.
Методы /v2/keypairs и лицензий в Resell API устарели и будут удалены — для SSH-ключей используйте Nova API.
Имена зон и записей DNS — полные, с точкой в конце.
Для пулов в Центральной Азии и Кении используются хосты *.servercore.com.
У каждого API есть OpenAPI-спецификация в JSON на странице документации (например, https://docs.selectel.ru/api/dns-actual.json).

Другие сценарии

Если этого недостаточно — официальная документация: https://docs.selectel.ru/api/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/selectel.md