Документація API

API hostd дозволяє керувати акаунтом програмно. Базова URL-адреса: https://api.hostd.cloud/v1.

АвтентифікаціяCopy Anchor Link

Більшість ендпоінтів потребують ключ API. Створіть ключ у порталі в Налаштування → Ключі API і надсилайте його як Bearer-токен:

Authorization: Bearer <your-api-key>

curl -H "Authorization: Bearer <your-api-key>" https://api.hostd.cloud/v1/network/ips/

Список кластерів публічний і не потребує автентифікації.

Ключ діє від вашого імені й ніколи не перевищує вашу роль у проєкті (зокрема в проєктах, якими з вами поділилися). Під час створення або редагування ключа ви обираєте, до чого він має доступ:

• Проєкти – ви обираєте окремі проєкти, з доступом Read (лише читання), Write (усе, крім видалення) чи Full (додатково видалення віртуальних машин, проєкту та публічних IP). Новий ключ не має доступу, доки ви його не надасте.
• Створення проєктів – вмикається окремо. Ключ отримує Full до проєктів, які створить.
• Ключі SSH – No access, Read або Write.
• Термін дії – 30 днів, 90 днів, 1 рік, вибрана дата або без терміну. За 7 днів до закінчення терміну дії ключа ми надішлемо вам e-mail.

IP-адреси виділених серверів і VPS недоступні для ключів API. Ключ працює лише з ендпоінтами з цієї документації – налаштування акаунта, білінг, звернення в підтримку та керування ключами API доступні тільки в порталі. Ті самі права діють для сервера MCP.

ЛімітиCopy Anchor Link

Запити з ключем API обмежуються на акаунт (усі ключі мають спільний ліміт):

• 10 запитів на секунду;
• 90 запитів на запис (POST, PUT, PATCH, DELETE) на хвилину.

Після перевищення ліміту API повертає 429 Too Many Requests із заголовком Retry-After (у секундах). Зачекайте цей час перед повторною спробою.

AI-агентиCopy Anchor Link

MCP-сервер дає AI-агентам (Cursor, Claude Code) доступ до того самого API.

ЕндпоінтиCopy Anchor Link

• Кластери – зони Public Cloud і погодинні ціни.
• Проєкти – проєкти, використання акаунта і задачі кластера.
• Віртуальні машини – створення, видалення, список, образи ОС, конфігурація, метрики, живлення, зміна ресурсів і нотатки.
• Висока доступність – увімкнення HA для VM і керування правилами розміщення.
• SSH-ключі – публічні SSH-ключі акаунта, які використовуються під час створення VM.
• Приватні мережі – вільні та зайняті адреси в приватній мережі.
• Знімки – один знімок на VM.
• Резервні копії – ручний запуск копії VM, відновлення копій VM, перегляд сховища резервних копій проєкту та завантаження файлів із копії.
• Завдання резервного копіювання – розклади резервного копіювання проєкту.
• Фаєрвол – фаєрвол усього проєкту одним запитом, а також опції та правила фаєрвола VM – по одному або весь упорядкований список одним запитом.
• Групи безпеки – групи безпеки проєкту та їхні правила – по одному або весь упорядкований список одним запитом.
• IP sets – набори IP-адрес проєкту та їхні елементи.
• IP addresses – призначені IP-адреси та PTR (акаунт і проєкт).