Для AI-агентов: markdown этой страницы — /docs-content/infra/deploy/runtimes.md индекс документации — /llms.txt

Список рантаймов

GET /v1/infra/runtimes

Возвращает список ID готовых рантаймов для передачи в POST /v1/infra/servers/:id/deploy (параметр runtime). Рантайм — необязательный параметр: если нужный стек входит в список, передайте его ID и платформа установит пакеты автоматически. Если нет — на отдельной виртуальной машине деплой без runtime полностью рабочий: установите нужное ПО через preStart в теле запроса. У galaxy-приложения runtime обязателен, а preStart не применяется. На POST /v1/infra/servers рантайм без source НЕ принимается с 2026-04-25 — см. RUNTIME_PARAM_REMOVED. В одношаговом создании galaxy-приложения runtime передаётся вместе с source; start также обязателен, кроме static, где поле необязательно и игнорируется. Каждый рантайм — это набор системных пакетов (nodejs, python, nginx, базы данных), устанавливаемых на сервер. Оценочное время установки — 2–4 минуты для базовых, до 4+ минут для комбинаций с несколькими пакетами.

Примеры

curl — личный ключ

Terminal

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/runtimes

curl — OAuth-приложение

Terminal

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/infra/runtimes

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/infra/runtimes', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data: runtimes } = await res.json()
runtimes.forEach(r => console.log(`${r.id}: ${r.name} (${r.estimatedSetupTime}s)`))

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/infra/runtimes', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data`	array	Массив рантаймов
`data[].id`	string	ID рантайма, передаётся как `runtime` при деплое (`POST /v1/infra/servers/:id/deploy`)
`data[].name`	string	Название для отображения пользователю
`data[].packages`	array<string>	Список пакетов, устанавливаемых на отдельной виртуальной машине (для справки)
`data[].estimatedSetupTime`	number	Оценочное время установки в секундах
`data[].supportedPlacements`	array<string>	Где рантайм доступен: `["standalone"]` — только отдельная виртуальная машина, `["standalone","galaxy"]` — ещё и галактика. Проверяйте это поле перед деплоем в галактику: рантайм с базой данных туда не ставится

Пример ответа

JSON

{
  "success": true,
  "data": [
    {
      "id": "node20",
      "name": "Node.js 20",
      "packages": ["nodejs-20", "npm", "pm2"],
      "estimatedSetupTime": 120,
      "supportedPlacements": ["standalone", "galaxy"]
    },
    {
      "id": "node20-pg",
      "name": "Node.js 20 + PostgreSQL",
      "packages": ["nodejs-20", "npm", "pm2", "postgresql-16"],
      "estimatedSetupTime": 180,
      "supportedPlacements": ["standalone"]
    },
    {
      "id": "python311-rag",
      "name": "Python 3.11 + RAG (pgvector + Redis)",
      "packages": ["python3.11", "pip", "postgresql-16", "pgvector", "redis"],
      "estimatedSetupTime": 240,
      "supportedPlacements": ["standalone"]
    }
  ]
}

Пример ответа при ошибке

401 — не передан API-ключ: