Для AI-агентов: markdown этой страницы — /docs-content/infra/providers/plans.md индекс документации — /llms.txt
Тарифы провайдера
GET /v1/infra/providers/:providerId/plans
Возвращает список тарифов провайдера с характеристиками (CPU, RAM, диск, цена за работу и за сон). Значение id используется как параметр plan при создании сервера.
Параметры
| Параметр | В | Тип | Обяз. | Описание |
|---|---|---|---|---|
providerId |
path | string | да | ID провайдера из GET /v1/infra/providers, например bitrix-cloud |
Примеры
curl — личный ключ
curl -H "X-Api-Key: YOUR_API_KEY" \
https://vibecode.bitrix24.tech/v1/infra/providers/bitrix-cloud/plans
curl — OAuth-приложение
curl -H "X-Api-Key: YOUR_APP_KEY" \
-H "Authorization: Bearer USER_SESSION_TOKEN" \
https://vibecode.bitrix24.tech/v1/infra/providers/bitrix-cloud/plans
JavaScript — личный ключ
const res = await fetch(
'https://vibecode.bitrix24.tech/v1/infra/providers/bitrix-cloud/plans',
{ headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { data: plans } = await res.json()
plans.forEach(p => console.log(
`${p.id}: ${p.cpu}C / ${p.ram}MB / ${p.disk}GB — ${p.priceMonthly} Ꝟ/мес`
))
JavaScript — OAuth-приложение
const res = await fetch(
'https://vibecode.bitrix24.tech/v1/infra/providers/bitrix-cloud/plans',
{
headers: {
'X-Api-Key': 'YOUR_APP_KEY',
'Authorization': 'Bearer USER_SESSION_TOKEN',
},
}
)
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
success |
boolean | Всегда true при успехе |
data |
array | Массив тарифов |
data[].id |
string | ID тарифа, передаётся как plan при создании сервера (bc-small, bc-medium, bc-large, bc-xlarge, bc-micro, bc-agent) |
data[].name |
string | Название тарифа с характеристиками для отображения пользователю |
data[].cpu |
number | Количество ядер |
data[].ram |
number | Оперативная память, МБ |
data[].disk |
number | Диск, ГБ |
data[].diskType |
string | Тип диска (network-ssd) |
data[].bandwidth |
number | Пропускная способность сети, Мбит/с |
data[].priceMonthly |
number | Каталожная цена работающего сервера в Вайбах (Ꝟ) за месяц — единицу называет поле currency. Фактическое списание за конкретный портал может отличаться от каталожной цены |
data[].sleepPriceMonthly |
number | Каталожная цена сервера в режиме sleeping в Вайбах (Ꝟ) за месяц. Фактическое списание может отличаться |
data[].currency |
string | Единица измерения priceMonthly и sleepPriceMonthly — валюта кошелька платформы, Вайбы (Ꝟ). Всегда "Vibes" |
data[].description |
string | (Опционально) Доп. описание тарифа, например "Для ботов и агентов" у bc-micro |
data[].platformId |
string | (Опционально) Платформа виртуализации провайдера, например standard-v2 |
data[].coreFraction |
string | (Опционально) Доля CPU — например "5" для 5% загрузки ядра. Приходит у вытесняемых тарифов bc-micro и bc-agent |
data[].preemptible |
boolean | (Опционально) true у вытесняемого тарифа. Приходит только у bc-micro и bc-agent, у остальных тарифов поле отсутствует — это равносильно false |
Пример ответа
{
"success": true,
"data": [
{
"id": "bc-small",
"name": "Small (2C / 2GB / 20GB SSD)",
"cpu": 2,
"ram": 2048,
"disk": 20,
"diskType": "network-ssd",
"bandwidth": 100,
"priceMonthly": 1200,
"sleepPriceMonthly": 180,
"currency": "Vibes"
},
{
"id": "bc-micro",
"name": "Micro (2C 5% / 4GB / 15GB SSD)",
"description": "Для ботов и агентов",
"cpu": 2,
"ram": 4096,
"disk": 15,
"diskType": "network-ssd",
"bandwidth": 100,
"priceMonthly": 600,
"sleepPriceMonthly": 130,
"currency": "Vibes",
"platformId": "standard-v2",
"coreFraction": "5",
"preemptible": true
}
]
}
Пример ответа при ошибке
404 — неизвестный providerId:
{
"success": false,
"error": {
"code": "NO_CREDENTIALS",
"message": "No credentials configured for provider nonexistent"
}
}
Ошибки
| HTTP | Код | Описание |
|---|---|---|
| 401 | MISSING_API_KEY |
Не передан заголовок X-Api-Key |
| 401 | INVALID_API_KEY |
Неверный или просроченный API-ключ |
| 404 | NO_CREDENTIALS |
Провайдер с таким providerId не сконфигурирован на платформе |
| 429 | RATE_LIMITED |
Превышен общий лимит запросов платформы |
Полный список общих ошибок API — Ошибки.
Известные особенности
- Тарифы
bc-micro(2C 5% / 4GB / 15GB SSD) иbc-agent(2C 5% / 2GB / 20GB SSD) — вытесняемые (preemptible) с 5% загрузкой ядра. Предназначены для ботов и агентов, где CPU расходуется точечно. Обычные приложения ставьте наbc-smallи выше. - Следствие вытесняемости. Вытесняемый тариф дешевле, но облако принудительно перезапускает такую машину примерно раз в сутки, с коротким окном недоступности. Платформа будит её обратно автоматически. Для непрерывных 24/7-нагрузок — демонов, обработчиков срочных заявок, всегда-онлайн агентов и ботов — выбирайте невытесняемый тариф,
bc-smallи выше. - Единицу цен не нужно выводить из провайдера или региона: она приходит в поле
currencyу каждого тарифа и всегда равна"Vibes"— та же пометка, что у стоимости поиска вGET /v1/me. - Ответ не пагинируется.