Dokumentacja API

API hostd pozwala zarządzać kontem programowo. Adres bazowy: https://api.hostd.cloud/v1.

UwierzytelnianieCopy Anchor Link

Większość endpointów wymaga klucza API. Utwórz klucz w portalu w Ustawienia → Klucze API i przesyłaj go jako token Bearer:

Authorization: Bearer <your-api-key>

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

Lista klastrów jest publiczna i nie wymaga uwierzytelnienia.

Klucz działa w Twoim imieniu i nigdy nie przekracza Twojej roli w projekcie (także w projektach udostępnionych Ci przez innych). Przy tworzeniu lub edycji klucza wybierasz, do czego ma dostęp:

• Projekty – wybierasz poszczególne projekty, z dostępem Read (tylko odczyt), Write (wszystko oprócz usuwania) lub Full (dodatkowo usuwanie maszyn wirtualnych, projektu i publicznych adresów IP). Nowy klucz nie ma dostępu, dopóki go nie nadasz.
• Tworzenie projektów – włączane osobno. Klucz dostaje Full do projektów, które utworzy.
• Klucze SSH – No access, Read lub Write.
• Ważność – 30 dni, 90 dni, 1 rok, wybrana data lub bez terminu. Na 7 dni przed wygaśnięciem klucza wyślemy Ci e-mail.

Adresy IP serwerów dedykowanych i VPS nie są dostępne dla kluczy API. Klucz działa tylko z endpointami opisanymi w tej dokumentacji – ustawienia konta, rozliczenia, zgłoszenia i zarządzanie kluczami API są dostępne wyłącznie w portalu. Te same uprawnienia obowiązują serwer MCP.

LimityCopy Anchor Link

Żądania z kluczem API są limitowane na konto (wszystkie klucze mają wspólny limit):

• 10 żądań na sekundę;
• 90 żądań zapisu (POST, PUT, PATCH, DELETE) na minutę.

Po przekroczeniu limitu API zwraca 429 Too Many Requests z nagłówkiem Retry-After (w sekundach). Odczekaj ten czas przed ponowieniem.

Agenci AICopy Anchor Link

Serwer MCP daje agentom AI (Cursor, Claude Code) dostęp do tego samego API.

EndpointyCopy Anchor Link

• Klastry – strefy Public Cloud i ceny godzinowe.
• Projekty – projekty, zużycie konta i zadania klastra.
• Maszyny wirtualne – tworzenie, usuwanie, lista, obrazy systemów, konfiguracja, metryki, zasilanie, zmiana zasobów i notatki.
• Wysoka dostępność – włączanie HA dla VM i zarządzanie regułami rozmieszczenia.
• Klucze SSH – klucze publiczne SSH na koncie, używane przy tworzeniu VM.
• Sieci prywatne – wolne i zajęte adresy w sieci prywatnej.
• Migawki – jedna migawka na VM.
• Kopie zapasowe – ręczne uruchomienie kopii VM, przywracanie kopii VM, przeglądanie repozytorium kopii projektu oraz pobieranie plików z kopii.
• Zadania backupu – harmonogramy kopii zapasowych projektu.
• Zapora – zapora całego projektu w jednym żądaniu oraz opcje i reguły zapory VM – pojedynczo albo cała uporządkowana lista jednym żądaniem.
• Grupy bezpieczeństwa – grupy bezpieczeństwa projektu i ich reguły – pojedynczo albo cała uporządkowana lista jednym żądaniem.
• IP sets – zbiory adresów IP projektu i ich elementy.
• IP addresses – przypisane adresy IP i rekordy PTR (konto i projekt).