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

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

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

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

```bash
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`).

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

- [Получить IAM-токен сервисного пользователя](https://mcp-everything.ru/integrations/selectel/scenarios/poluchit-iam-token-servisnogo.md)
- [Управлять DNS-записями домена](https://mcp-everything.ru/integrations/selectel/scenarios/upravlyat-dns-zapisyami-domena.md)
- [Создать облачный проект и выделить публичные IP](https://mcp-everything.ru/integrations/selectel/scenarios/sozdat-oblachnyy-proekt-i-vydelit.md)

---

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