API DLA KLIENTÓW · V1 BETA
REST API dla
VPS i serwerów dedykowanych
Zarządzaj serwerami z poziomu kodu: zamawiaj i likwiduj godzinowe VPS, wykonuj operacje zasilania i reinstalacje, twórz i wdrażaj własne obrazy oraz opłacaj faktury ze środków na koncie.
API dla klientów X-ZoneServers (v1, publiczna beta) udostępnia przez HTTPS 92 operacje ze specyfikacją OpenAPI 3.0, kluczami API z zakresami uprawnień i domyślnym limitem 1 000 żądań na godzinę na klucz. Jest dostępne na każdym koncie bez dodatkowych opłat.
92 operacje API1 000 żądań na godzinę na klucz
Twoje pierwsze wywołanie
Utwórz klucz w panelu klienta w sekcji Profile → API Keys, a następnie zapytaj API, kim jesteś.
curl https://my.x-zoneservers.com/api/v1/ \
-H "Authorization: Bearer $XZ_API_KEY"
{ "success": true,
"data": {
"version": "1",
"key": { "scopes": ["read", "services"] },
"rate_limit": { "limit": 1000, "remaining": 999 }
} }01Funkcje
Co możesz zautomatyzować
API obejmuje cały cykl życia serwera — od zamówienia po fakturę — z tymi samymi uprawnieniami co panel klienta.
Wdrażanie i likwidacja
Zamów VPS z rozliczeniem godzinowym lub miesięcznym, przekaż user-data dla cloud-init i klucze SSH na pierwsze uruchomienie, a po zakończeniu zadania usuń serwer. Rozliczanie godzinowe kończy się w chwili, gdy serwer znika.
Zasilanie, reinstalacja i statystyki
Uruchamiaj, zatrzymuj, restartuj i reinstaluj swoje VPS, resetuj hasła roota oraz odczytuj statystyki zużycia i ruchu ze swoich skryptów monitorujących.
Własne obrazy
Zapisz VPS jako obraz (do 3 na konto) albo zarejestruj własny obraz qcow2 lub raw (weryfikowany sumą SHA-256) i wdrażaj z niego nowe serwery.
Rozliczenia i zużycie
Sprawdzaj saldo środków i opłaty godzinowe naliczone w tym miesiącu, pobieraj listę faktur i faktur proforma oraz opłacaj je ze środków na koncie — przydatne w dashboardach kosztów i alertach budżetowych.
Dodatki i rozbudowa
Kupuj dodatki do istniejącej usługi, np. dodatkowe adresy IP, albo przenieś ją na większy plan bez otwierania panelu.
Projekty i klucze z zakresem uprawnień
Grupuj serwery w projekty i wydawaj klucze przypisane do jednego projektu, aby klucz ze środowiska staging nigdy nie widział produkcji ani nie mógł jej dotknąć.
02Jak to działa
Przykład: godzinowy VPS dla jednego zadania CI
Utwórz czystą maszynę do buildów, uruchom pipeline, usuń ją — i zapłać za godziny, w których istniała.
Usługi godzinowe są opłacane ze środków na koncie, a nie fakturowane, więc utrzymuj na koncie dodatnie saldo. Do każdego zamówienia dołączaj nagłówek Idempotency-Key: żądanie, które przekroczyło limit czasu, można wtedy ponowić bez tworzenia drugiego serwera.
1. Wybierz plan: pobierz listę produktów z cenami godzinowymi i miesięcznymi.
curl https://my.x-zoneservers.com/api/v1/products \
-H "Authorization: Bearer $XZ_API_KEY"2. Zamów go z rozliczeniem godzinowym, ze skryptem pierwszego uruchomienia i swoim kluczem SSH.
curl -X POST https://my.x-zoneservers.com/api/v1/orders \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Idempotency-Key: ci-run-4812" \
-H "Content-Type: application/json" \
-d '{"productId": "<plan-id>", "billingCycle": "hourly",
"hostname": "ci-4812.example.com", "location": "<location>",
"configOptions": {"os_image_id": "<image-id>",
"ssh_keys": ["ssh-ed25519 AAAA... ci@runner"],
"user_data": "#!/bin/sh\n/opt/ci/run-pipeline.sh"}}'3. Gdy zadanie się zakończy, usuń serwer. Naliczanie opłat ustaje natychmiast.
curl -X DELETE https://my.x-zoneservers.com/api/v1/vps/<vps-id> \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"immediate": true}'03API
Stworzone dla skryptów i agentów AI
Gdy przyciski klika program, a nie człowiek, przewidywalne zachowanie liczy się bardziej niż liczba endpointów.
Klucze z zakresem uprawnień
Każdy klucz ma tylko nadane przez Ciebie zakresy — read, services, orders, billing, destructive — a do tego opcjonalną listę dozwolonych adresów IP i datę wygaśnięcia.
Opublikowane limity żądań
Domyślnie 1 000 żądań na godzinę na klucz, ze stanem limitu w nagłówkach X-RateLimit, oraz krótkie okresy odczekania dla każdego serwera przy operacjach zasilania i reinstalacji.
Bezpieczne ponawianie
Zamówienia przyjmują Idempotency-Key, a każda odmowa zwraca kod błędu czytelny dla maszyn, więc automatyzacja odróżni błąd przejściowy, który można ponowić, od rzeczywistego.
Dokumentacja czytelna dla maszyn
Specyfikacja OpenAPI 3.0 dla generatorów klientów oraz przewodnik w czystym Markdownie, który asystenci programowania i agenci AI mogą czytać bezpośrednio.
04Powiązane
Sprzedajesz serwery własnym klientom?
To API dla klientów automatyzuje Twoje własne konto. Aby odsprzedawać usługi pod własną marką, dołącz do programu resellerskiego i korzystaj z Reseller API: ceny hurtowe z progami wolumenowymi, żądania podpisywane HMAC, webhooki, klucze przypisane do klientów oraz linki do konsoli, które Twoi klienci otwierają bez zakładania u nas konta.
05Pytania
FAQ — API
Najczęstsze pytania o automatyzację X-ZoneServers.
Czy X-ZoneServers ma API?
Tak. API dla klientów (v1) to REST API działające przez HTTPS pod adresem https://my.x-zoneservers.com/api/v1, z 92 operacjami obejmującymi VPS, serwery dedykowane, zamówienia, dodatki, rozbudowy, faktury, klucze SSH i własne obrazy. Jest w fazie publicznej bety: wystarczająco stabilne, by na nim budować, ale endpointy i struktura odpowiedzi mogą się jeszcze zmienić.
Czy dostęp do API jest bezpłatny?
Tak. Dostęp do API wchodzi w skład każdego konta bez dodatkowych opłat; płacisz tylko za zamówione serwery i dodatki — po tych samych cenach co na stronie i w panelu klienta.
Czy przez API mogę tworzyć i usuwać VPS rozliczane godzinowo?
Tak. Złóż zamówienie z cyklem rozliczeniowym ustawionym na godzinowy, opcjonalnie z user-data dla cloud-init i kluczami SSH, a gdy VPS nie będzie już potrzebny, usuń go. Usługi godzinowe są opłacane ze środków na koncie, a naliczanie ustaje zaraz po ich usunięciu.
Czy API działa z serwerami dedykowanymi?
Częściowo. W przypadku serwerów dedykowanych API obejmuje zamawianie, dodatki, faktury i szczegóły usługi. Sterowanie zasilaniem, reinstalacja systemu i reset hasła nie są dostępne dla serwerów dedykowanych ani przez API, ani w panelu klienta.
Jak się uwierzytelnić?
Utwórz klucz API w panelu klienta w sekcji Profile → API Keys i wysyłaj go jako token Bearer. Zakresy uprawnień wybierasz przy tworzeniu klucza; opcjonalnie możesz go ograniczyć do konkretnych adresów IP lub nadać mu datę wygaśnięcia. Klucz jest wyświetlany tylko raz i można go w każdej chwili unieważnić w panelu.
Czy jest dostępna specyfikacja OpenAPI lub Swagger?
Tak. Pełna specyfikacja OpenAPI 3.0 jest opublikowana pod adresem https://my.x-zoneservers.com/api/v1/openapi.json, obok wyrenderowanej dokumentacji i przewodnika po użyciu w formacie Markdown.
Zacznij
Utwórz swój pierwszy klucz API
Zaloguj się do panelu klienta, otwórz Profile → API Keys i wykonaj pierwsze wywołanie w niecałą minutę. Pytania o API trafiają bezpośrednio do osób, które budują platformę.