API / Початок роботи / API-токени

API-токени

API-токен — це ключ для бота або скрипта. З ним програма робить те саме, що ви в панелі: переглядає сервери, перезапускає їх, надсилає команди в консоль, продовжує оренду. Ваш пароль при цьому нікуди не передається.

Як створити токен

Меню акаунта → «Налаштування» → вкладка «API-токени».

Вкладка «API-токени»

  1. «Підключити до AI» — токен із готовим набором прав для AI-асистента, див. «AI-асистенти (MCP)».
  2. «Створити токен» — новий токен із нуля.
  3. Картка токена: права, проєкти, термін дії, коли востаннє використовувався та скільки витрачено.
  4. «Змінити» права й обмеження або відкликати токен (кошик).

Токен створюється у два кроки.

Крок 1. Назва й доступ

Крок 1: назва й доступ

  1. Кроки форми — між ними можна перемикатися.
  2. Назва — зрозуміла, наприклад «Discord-бот» або «Деплой із CI».
  3. Термін дії — 30, 90, 365 днів або безстроково.
  4. Проєкти — усі або лише вибрані. У вибраного проєкту можна натиснути «Вибрати послуги» й пустити токен лише до конкретних серверів.
  5. Дозволені IP — по одному на рядок, можна діапазони (CIDR). Порожньо — з будь-якої адреси.

Натисніть «Далі».

Крок 2. Права

Крок 2: права й ліміт витрат

  1. Перемикач групи вмикає її основні права.
  2. «Налаштувати» розкриває окремі права групи.
  3. Небезпечні права — витрати з балансу, видалення проєктів і послуг — підсвічено червоним, і перемикач групи їх не вмикає: їх позначають вручну.
  4. Ліміт витрат — з'являється, коли позначено billing:spend.
  5. «Створити».

Токен створено

Після створення скопіюйте токен кнопкою «Скопіювати».

Токен показується один раз. Ми зберігаємо лише його відбиток і не зможемо показати токен знову. Загубили — відкличте і створіть новий.

Про кожен новий токен надходить лист, а якщо підключено Telegram — ще й повідомлення. Якщо токен створювали не ви, відкличте його і змініть пароль.

Права

ГрупаПравоЩо дозволяє
Акаунтaccount:readПрофіль, баланс, зведення, реферальна програма
account:writeЗміна профілю, мови й налаштувань сповіщень
Фінансиbilling:readІсторія платежів і покупок
billing:topupСтворення посилань на поповнення (оплачуєте їх ви самі)
billing:spendВитрати з балансу: оренда, продовження, зміна тарифу
Проєктиprojects:readСписок проєктів
projects:writeСтворення й перейменування проєктів
projects:deleteВидалення проєктів
projects:membersДодавання й видалення учасників
Сервериservers:readСписок послуг, статус, навантаження, параметри, бекапи, завдання
servers:powerСтарт, стоп, рестарт
servers:manageПерейменування, перевстановлення, порт, IP, параметри запуску
servers:consoleПідключення до консолі й надсилання команд
servers:filesЧитання й запис файлів сервера (конфіги, плагіни)
servers:accessДоступи до сервера й дані SFTP
servers:cronЗавдання за розкладом
servers:backupsСтворення, відновлення й видалення бекапів
servers:deleteВидалення послуг
FastDLfastdl:read / fastdl:writeПерегляд FastDL / стиснення файлів
Підтримкаsupport:read / support:writeЧитання звернень / нові звернення й відповіді

Токен ніколи не може більше, ніж ви самі. Якщо вас прибрали з проєкту, токен теж втрачає до нього доступ.

Ліміт витрат

Право billing:spend видається лише разом із лімітом: за 24 години, за 30 днів або обидва одразу. Покупка, яка вивела б токен за ліміт, відхиляється, гроші не списуються. Скільки вже витрачено, видно в списку токенів.

Проєкти, IP і термін

  • Проєкти. Токен, обмежений проєктами, не бачить інших і не може створювати нові. Якщо в проєкті вибрано окремі послуги, токен бачить лише їх і нічого не змінює на рівні проєкту.
  • IP-адреси. Адреси або діапазони (CIDR) по одному на рядок. З інших адрес токен не приймуть.
  • Термін. 30, 90 або 365 днів чи безстроково. Прострочений токен перестає працювати сам.

Що через токен зробити не можна

Вхід і вихід, сесії, зміна пароля й пошти, двофакторний захист, passkey, прив'язка Telegram, видалення акаунта й керування самими токенами — усе це доступно лише вам у браузері.

Далі: огляд API, помилки й коди відповіді і довідник методів.