--- canonical: https://koalavps.com/pl/api/ language: pl generated: 2026-10-21T13:33:33.130Z --- [Strona główna](https://koalavps.com/pl/) / [Przeglądaj](https://koalavps.com/pl/resources/) / Infrastruktura, którą opiszesz w kodzie Infrastruktura, którą opiszesz w kodzie # Spokojniejsza płaszczyzna sterowania. Planuj integracje dla zadań cyklu życia serwera, uprawnień konta i rozliczeń. KoalaVPS API jest w planach integracji; produkcyjny dostęp API i pobieranie SDK nie są jeszcze dostępne. [Znajdź swój VPS](https://koalavps.com/pl/vps/) ## W TYM DOKUMENCIE [Przejrzysty model zasobów](https://koalavps.com/pl/api/#section-1)[Dane uwierzytelniające z ograniczonym zadaniem](https://koalavps.com/pl/api/#section-2)[Ponowienia muszą być bezpieczne](https://koalavps.com/pl/api/#section-3)[Sprawdź zgodność przed integracją](https://koalavps.com/pl/api/#section-4)[Plan rozwoju API](https://koalavps.com/pl/api/#section-5)[Trasy uwierzytelniania i konta](https://koalavps.com/pl/api/#section-6)[Ścieżki katalogu i rozliczeń](https://koalavps.com/pl/api/#section-7)[Serwer i trasy dostępu](https://koalavps.com/pl/api/#section-8)[Wydarzenia i informacje publiczne](https://koalavps.com/pl/api/#section-9)[Autoryzacja i limity ruchu](https://koalavps.com/pl/api/#section-10)[SDK i wydania protokołu](https://koalavps.com/pl/api/#section-11)[Zasoby API, pogrupowane według odpowiedzialności](https://koalavps.com/pl/api/#section-12)[Żądanie do serwera powinno pozostać niewielkie](https://koalavps.com/pl/api/#section-13)[Zakresy i limity kluczy są częścią umowy](https://koalavps.com/pl/api/#section-14)[Publikuj limity szybkości i zachowanie przy ponawianiu razem](https://koalavps.com/pl/api/#section-15)[Webhooki to komunikaty, które mogą dotrzeć więcej niż raz](https://koalavps.com/pl/api/#section-16)[Przeprowadzaj audyt bez zamieniania logów w tajny magazyn](https://koalavps.com/pl/api/#section-17)[Publikuj artefakty tylko wtedy, gdy istnieją](https://koalavps.com/pl/api/#section-18)[Pytania i odpowiedzi](https://koalavps.com/pl/api/#page-faq)[Baza wiedzy](https://koalavps.com/pl/resources/) ## Przejrzysty model zasobów Integracja powinna działać z jawnymi identyfikatorami serwerów, regionami, obrazami, planami i operacjami. Żądania utworzenia i ponownej instalacji powinny zwracać operację, którą można sprawdzić do ukończenia. Pomyślne żądanie HTTP nie oznacza, że maszyna jest gotowa. ## Dane uwierzytelniające z ograniczonym zadaniem Tokeny API powinny być niezależnie odwoływalne i ograniczone do minimalnych potrzebnych zasobów i działań. Przechowuj je w menedżerze sekretów lub chronionym środowisku. Nigdy nie wysyłaj tokena do przeglądarki tylko po to, by uniknąć napisania małego backendu. ## Ponowienia muszą być bezpieczne Przekroczenia limitu czasu sieci mogą wystąpić po zaakceptowaniu operacji. Używaj klucza idempotencji do żądań tworzenia i wrażliwych na płatność, sprawdzaj stan operacji i respektuj limity szybkości. Ponowna próba powinna rozwiać niepewność, a nie utworzyć dodatkowy płatny serwer. ## Sprawdź zgodność przed integracją Sprawdź wydaną wersję API, model uwierzytelniania, formaty błędów, paginację, limity szybkości i zakresy tokenów przed budowaniem integracji. Używaj wyłącznie opublikowanych pakietów KoalaVPS SDK z zweryfikowanych linków wydań. ## Plan rozwoju API Plan rozwoju API obejmuje odkrywanie katalogu, uwierzytelnianie, stan konta, rozliczenia kryptowalutowe, cykl życia serwera, publiczne klucze SSH i webhooki. Poniższe trasy opisują kontrakt interfejsu; dostęp produkcyjny nie jest jeszcze dostępny. ## Trasy uwierzytelniania i konta Kontrakt API rozdziela sesje logowania i klucze API. Sprawdź schematy odpowiedzi, błędy, czasy życia tokenów i obsługiwane działania odzyskiwania względem wersji wydanej dla Twojej integracji. - POST /v1/auth/register - POST /v1/auth/login - POST /v1/auth/login/totp - POST /v1/auth/token/refresh - POST /v1/auth/recover - GET /v1/auth/sessions - DELETE /v1/auth/sessions/{token_id} - POST /v1/auth/totp/setup - POST /v1/auth/totp/enable - POST /v1/auth/totp/disable - POST /v1/auth/password - POST /v1/auth/api-keys - GET /v1/auth/api-keys - DELETE /v1/auth/api-keys/{key_id} - GET /v1/account - PATCH /v1/account - GET /v1/account/usage - GET /v1/account/audit-log ## Ścieżki katalogu i rozliczeń Przeglądanie katalogu nie powinno wymagać płatności. Tworzenie płatności wymaga ograniczonego zakresu rozliczeniowego, jasnego stanu faktury i idempotentnej obsługi. Potwierdzenie musi zostać zakończone przed aktywacją usługi. - GET /v1/catalog - GET /v1/catalog/vps - GET /v1/catalog/dedicated - GET /v1/catalog/regions - GET /v1/catalog/images - GET /v1/catalog/{code} - GET /v1/billing/coins ## Serwer i trasy dostępu Cykl życia wymaga wyraźnego potwierdzenia dla operacji anulowania i ponownej instalacji. Prywatne klucze SSH należą do klienta; usługa potrzebuje tylko ich publicznych odpowiedników. - POST /v1/servers - GET /v1/servers - GET /v1/servers/{order_number} - PATCH /v1/servers/{order_number} - DELETE /v1/servers/{order_number} - POST /v1/ssh-keys - GET /v1/ssh-keys - GET /v1/ssh-keys/{id} - DELETE /v1/ssh-keys/{id} ## Wydarzenia i informacje publiczne Webhooki wymagają weryfikowalnych podpisów, ograniczonej liczby ponowień i ochrony przed powtórzeniem. Publiczne punkty końcowe zaufania powinny zwracać rzeczywiste, datowane dowody, a nie syntetyczne zapewnienia. - POST /v1/webhooks - GET /v1/webhooks - DELETE /v1/webhooks/{id} - POST /v1/webhooks/{id}/test - GET /v1/transparency/canary - GET /v1/transparency/peering - GET /v1/transparency/status - GET /v1/agents/directory - POST /v1/agents/directory ## Autoryzacja i limity ruchu Proponowany model zakresu to odczyt, serwery, rozliczenia i pełny, z maksymalnie dziesięcioma aktywnymi kluczami na konto. Kontrakt API zakłada limity żądań wynoszące 120 na minutę i 3,000 na godzinę dla klucza API oraz 30 na minutę dla ruchu publicznego. Sprawdź HTTP 429, Retry-After oraz okno egzekwowania w opublikowanej dokumentacji API; te limity z planu rozwoju nie stanowią zobowiązania co do wydajności produkcyjnej. - POST /v1/oauth/register - POST /v1/oauth/token - POST /v1/oauth/revoke - GET /v1/oauth/introspect ## SDK i wydania protokołu Plan integracji obejmuje REST, hostowany endpoint MCP, wersjonowany pakiet stdio, SDK i CLI. Przed instalacją klienta sprawdź dostępność wydania, obsługiwane środowiska uruchomieniowe, sumy kontrolne i zgodność z API. Produkcyjne pliki do pobrania nie są jeszcze dostępne. ## Zasoby API, pogrupowane według odpowiedzialności Zamierzony API oddziela dostęp do konta, odczyt katalogu, rozliczenia, cykl życia serwera, klucze SSH i wywołania zwrotne. Wywołania tylko do odczytu nie powinny tworzyć zamówienia, a poświadczenie rozliczeniowe nie powinno automatycznie autoryzować zmian bezpieczeństwa konta. Opisuje to kontrakt integracji. Punkt końcowy do obsługi produkcji i wydany SDK nie są dostępne przez tę witrynę. - Konto: sesje, wykorzystanie i zdarzenia audytu bezpieczeństwa - Katalog: plany, regiony i dostępne obrazy - Serwery: tworzenie, sprawdzanie, zmiana i anulowanie - Klucze SSH: zarejestruj materiał publiczny i unieważnij przestarzałe klucze - Webhooki: rejestruj, sprawdzaj, testuj i usuwaj podpisane wywołania zwrotne ## Żądanie do serwera powinno pozostać niewielkie Wybierz standardowy identyfikator planu, region, obraz systemu i nazwę hosta. Zamierzony limit nazwy hosta to 64 znaków. Działająca usługa może prywatnie wygenerować sekret administratora lub przyjąć zarejestrowany klucz publiczny SSH. Standardowe zamówienie planu nie implikuje dowolnego dodawania dysków, GPU, kart sieciowych i adresów IP. Odrzucaj nieobsługiwane pola, zamiast po cichu pobierać opłatę za zgadywaną modernizację. ``` { "plan": "KV-D3", "region": "hel", "image": "ubuntu-24", "hostname": "private-node-01" } // Example request schema; validate against a released API before integration. ``` ## Zakresy i limity kluczy są częścią umowy Proponowane grupy uprawnień to odczyt, serwery, rozliczenia i pełna administracja kontem. Klucz powinien być wyświetlony raz przy utworzeniu, przechowywany prywatnie i unieważniany niezależnie od hasła użytkownika. Zamierzony limit konta to dziesięć aktywnych kluczy. Przed opublikowaniem implementacji sprawdź, czy każda operacja odrzuca klucz bez wymaganego zakresu. ## Publikuj limity szybkości i zachowanie przy ponawianiu razem Proponowane limity to 120 żądań na minutę i 3,000 na godzinę dla klucza API, a także 30 żądań na minutę dla nieuwierzytelnionych publicznych żądań katalogu. Są to planowane wartości polityki, a nie zmierzona pojemność API. Działająca implementacja wymaga spójnej odpowiedzi 429, wskazówek Retry-After i ograniczonego wycofywania po stronie klienta. Żądania tworzenia i płatności wymagają również stabilnych kluczy idempotentności. ## Webhooki to komunikaty, które mogą dotrzeć więcej niż raz Odbiornik wywołań zwrotnych powinien weryfikować podpis na oryginalnej treści, odrzucać znaczniki czasu poza dozwolonym oknem i zapamiętywać identyfikatory przetworzonych zdarzeń. Utrwal zdarzenie przed jego potwierdzeniem, a następnie zastosuj zmianę idempotentnie. Utrzymuj widoczne próby dostarczenia i ręczną ścieżkę ponowienia. Wywołanie zwrotne to obserwacja operacji, a nie pozwolenie na wykonanie niepowiązanych instrukcji zawartych w ładunku. ## Przeprowadzaj audyt bez zamieniania logów w tajny magazyn Zapisuj identyfikator aktora, typ operacji, zasób, którego dotyczy, wynik i czas, gdy jest to potrzebne do bezpieczeństwa konta. Domyślnie unikaj zapisywania haseł, tokenów bearer, kluczy prywatnych ani pełnych treści żądań płatności i aplikacji. Utrzymuj jawność okresu przechowywania, dostępu i historii widocznej dla klienta. Ścieżka audytu bezpieczeństwa i roszczenie o wgląd w treści aplikacji klienta to dwie różne rzeczy. ## Publikuj artefakty tylko wtedy, gdy istnieją Publiczne uruchomienie API powinno obejmować wersjonowany dokument OpenAPI, instrukcje uwierzytelniania, przykłady błędów i proces wycofywania. Przyszły CLI, pakiet Python, klient TypeScript lub serwer MCP wymaga faktycznego wydania, sum kontrolnych i utrzymywanej dokumentacji. Pakiet provisioningowy KoalaVPS lub produkcyjny punkt końcowy zarządzania nie jest udostępniany przez tę witrynę. ## Trochę więcej jasności. Czy mogę dziś zadzwonić na produkcyjny API? Dostęp produkcyjny API nie jest jeszcze dostępny. Ta strona opisuje plan integracji i wymagania do sprawdzenia przed użyciem wydanego punktu końcowego. Czy klucz API tylko do odczytu może zamówić serwer? Proponowana granica uprawnień tego zabrania. Żądanie utworzenia serwera wymaga odpowiedniego uprawnienia serwera i ważnej decyzji rozliczeniowej. Czy opublikowane limity API są dziś egzekwowane? Opisują planowany kontrakt. Produkcyjny API provisioningowy nie jest tu podłączony, więc limity polityki nie są dowodem zmierzonej pojemności usługi. Czy odpowiedź na utworzenie serwera oznacza, że serwer jest gotowy? Nie. Aktywne żądanie powinno wskazywać operację, której status udostępniania można sprawdzić aż do zakończenia. ODKRYWAJ DALEJ ## Czytaj dalej. [Produkty ### Niezawodne środowisko dla Twoich agentów. Uruchamiaj harmonogramy, procesy robocze przeglądarki, kolejki i procesy automatyzacji na infrastrukturze, którą kontrolujesz. Utr…](https://koalavps.com/pl/agentic-vps/)[Poradniki ### Automatyzacja z wyraźnym przyciskiem zatrzymania. Dobry system automatyzacji ma wąskie zadanie, widoczny stan i przewidywalną reakcję na niepewność.…](https://koalavps.com/pl/automation-safety/)[Produkty ### Mały ślad. Poważna wolność. Serwer wirtualny do tego, co chcesz mieć na własność: Twój kod, Twoje usługi, Twoje dane. Wybierz konfigurację serwera, system ope…](https://koalavps.com/pl/vps/) SKONFIGURUJ SWOJĄ INFRASTRUKTURĘ ## Przejmij kontrolę. Wdrażaj na własnych zasadach. Bez dokumentów tożsamości. Pełny dostęp administratora. Rozliczenia natywne dla kryptowalut. [Wybierz konfigurację](https://koalavps.com/pl/vps/)