Документація API
Довідник HTTP API hostd.
API hostd дозволяє керувати акаунтом програмно. Базова URL-адреса: https://api.hostd.cloud/v1.
Автентифікація
Більшість ендпоінтів потребують ключ API. Створіть ключ у порталі в Налаштування → Ключі API і надсилайте його як Bearer-токен:
Authorization: Bearer <your-api-key>curl -H "Authorization: Bearer <your-api-key>" https://api.hostd.cloud/v1/network/ips/Список кластерів публічний і не потребує автентифікації.
Ключ діє з вашими правами: має доступ до кожного проєкту, учасником якого ви є, з вашою роллю в ньому (зокрема до проєктів, якими з вами поділилися). Він працює лише з ендпоінтами з цієї документації — налаштування акаунта, білінг, звернення в підтримку та керування ключами API доступні тільки в порталі.
Власник проєкту може обмежити ключі API в кожному проєкті: Full access, Read-only (лише читання) або No access (проєкт невидимий для ключів). Це налаштовується в порталі під час редагування проєкту → API access. Обмеження діє для кожного ключа API, зокрема для сервера MCP, і ніколи не перевищує вашу роль; на сам портал воно не впливає.
Ліміти
Запити з ключем API обмежуються на акаунт (усі ключі мають спільний ліміт):
- 5 запитів на секунду;
- 30 запитів на запис (
POST,PUT,PATCH,DELETE) на хвилину.
Після перевищення ліміту API повертає 429 Too Many Requests із заголовком Retry-After (у секундах). Зачекайте цей час перед повторною спробою.
AI-агенти
MCP-сервер дає AI-агентам (Cursor, Claude Code) доступ до того самого API.
Ендпоінти
- Кластери — зони Public Cloud і погодинні ціни.
- Проєкти — проєкти, використання акаунта і задачі кластера.
- Віртуальні машини — створення, видалення, список, образи ОС, конфігурація, метрики, живлення, зміна ресурсів, нотатки і HA.
- SSH-ключі — публічні SSH-ключі акаунта, які використовуються під час створення VM.
- Приватні мережі — вільні та зайняті адреси в приватній мережі.
- Знімки — один знімок на VM.
- Резервні копії — відновлення і видалення резервних копій наявної VM.
- Фаєрвол — опції та правила фаєрвола VM.
- IP addresses — призначені IP-адреси та PTR (акаунт і проєкт).