Lista zmian

KernelHost API

Wersjonowanie semantyczne. Zmiany łamiące kompatybilność (zmiana nazw pól, usunięcie endpointów, zmiana schematu uwierzytelniania) trafiają wyłącznie do nowej wersji głównej pod nowym prefiksem URL /v2/. W ramach /v1/ wprowadzane są tylko zmiany addytywne (nowe opcjonalne pola, nowe endpointy).

v1.4.0 (2026-11-09)

  • Nowa ścieżka GET /v1/services/{id}/metrics (uprawnienie read:services): metryki serwera dla okresów 1h, 6h, 24h, 7d i 14d. Edge Unlimited Traffic VPS dostarczają dane o CPU, pamięci, sieci i ruchu wychodzącym, a standardowe VPS Unlimited Traffic dane o ruchu sieciowym przychodzącym i wychodzącym w lokalizacjach wymienionych w referencji endpointów.
  • Nowe ścieżki GET /v1/services/{id}/ddos/attacks i GET /v1/services/{id}/ddos/attacks/{attack_id} (uprawnienie read:ddos): raporty ataków dla Remote DDoS Protection do 90 dni wstecz, z przebiegiem ruchu i zestawieniami według protokołu, portu, źródła i rozmiaru pakietów.
  • Profile i reguły (/ddos/profiles, /ddos/rules i operacje zapisu): usługa Twojego konta, która nie jest usługą Advanced DDoS Protection, zwraca teraz HTTP 409 not_supported_for_product zamiast HTTP 404. Nieznane lub cudze identyfikatory usług nadal zwracają HTTP 404.

v1.3.1 (2026-11-02)

  • Niemcy i Francję można wybrać osobno: „Niemcy (Europa)” oznaczają serwer wyłącznie w Niemczech, we Frankfurcie, a „Francja (Europa)” wyłącznie we Francji.
  • Uruchomienie standardowych VPS Unlimited Traffic w lokalizacjach Europa, Niemcy, Francja, Kanada Wschodnia, Wielka Brytania i Polska może potrwać do 7 dni. W większości przypadków serwer jest gotowy w ciągu 48 godzin. Opłacony okres zaczyna się dopiero po otrzymaniu serwera.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: odczyt profili i reguł, dodawanie reguł oraz usuwanie własnych reguł przez cztery nowe ścieżki. Jawnie włącz read:ddos i write:ddos; istniejące klucze nie otrzymują nowych uprawnień.
  • Wspólne limity panelu i API, zmiany wykonywane kolejno oraz wymagany Idempotency-Key dla POST i DELETE chronią przed masowym dodawaniem reguł i równoległymi żądaniami.

v1.2.2 (2026-10-27)

  • POST /v1/orders: jeśli opłaconej usługi nie da się od razu uruchomić, jej identyfikator znajduje się teraz w polu awaiting_setup (status awaiting_setup), a nie w provisioning_failures ze statusem partial. Usługa zostanie uruchomiona automatycznie, gdy tylko będzie to możliwe, a następnie przejdzie w stan active. W takim przypadku proszę nie składać zamówienia ponownie.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: nowe lokalizacje z dopłatą w Europie, Ameryce Północnej i Południowej, Azji, na Bliskim Wschodzie, w Afryce i Australii. GET /v1/products/{id} zwraca je z nazwą wyświetlaną i dopłatą. Jeśli taka lokalizacja jest akurat wyprzedana, POST /v1/orders zwraca HTTP 409 location_sold_out. Bez podania lokalizacji nadal obowiązuje pierwsza z listy (Europe).
  • Opcje konfiguracyjne (lokalizacja i system operacyjny) taryf Dedicated Unlimited Traffic VPN i Dedicated High Speed Unlimited Traffic VPN mają nowe identyfikatory, podobnie jak ich podopcje. Identyfikatory proszę odczytywać z GET /v1/products/{id}; zapisany na stałe stary identyfikator daje HTTP 400 validation_failed. W przypadku usług tych taryf, których status już przed tą zmianą miał wartość cancelled, terminated lub fraud, GET /v1/services/{id} zwraca od tej pory location o wartości null. High Speed VPN można teraz zamówić tylko z opcjami lokalizacji Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) i Poland (Europe).
  • Edge Unlimited Traffic VPS: sześć nowych lokalizacji (Frankfurt am Main, Londyn, Chester, Paryż, Warszawa i Waszyngton), łącznie do 25. Nowe lokalizacje mają własne wartości sub_option_id, identyfikatory dotychczasowych lokalizacji się nie zmieniają. W niektórych taryfach cena bazowa i dopłaty za lokalizację są rozłożone inaczej, ceny łączne dotychczasowych lokalizacji pozostają bez zmian. Identyfikatory i ceny proszę zawsze odczytywać z GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders dla produktów z wyborem lokalizacji (Edge Unlimited Traffic VPS): opcja lokalizacji nie ma wartości domyślnej i trzeba ją przesłać w config_options, w przeciwnym razie HTTP 422 z reason location_required. Wyprzedana lokalizacja zwraca HTTP 409 location_sold_out. Nowe opcjonalne pole storage_gb ustala łączną przestrzeń dyskową od 20 do 300 GB. 20 GB jest wliczone w cenę taryfy i obowiązuje, gdy pole zostanie pominięte, każdy dodatkowy GB jest rozliczany według ceny z GET /v1/products/{id}. Inne wartości dają HTTP 422 storage_out_of_range.
  • Dla tych produktów wynik zamówienia zawiera location i storage_gb (łączna przestrzeń dyskowa w GB), a GET /v1/products/{id} opisuje w polu storage zakres przestrzeni dyskowej i cenę za każdy dodatkowy GB. GET /v1/services i GET /v1/services/{id} zwracają location i storage_gb dla każdej usługi (null, jeśli produkt nie ma takiego wyboru).
  • GET /v1/products/{id} zwraca podopcje już tylko z ich nazwą wyświetlaną (na przykład "Finland (Europe)"), bez poprzedzającej ją wartości wewnętrznej. POST /v1/orders odrzuca produkty, które są aktualnie wyprzedane, z kodem HTTP 409 out_of_stock.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options przyjmuje tylko opcje i wartości widoczne w sklepie oraz ilości w ich granicach. Pominięte widoczne opcje otrzymują pierwszą wartość z listy, dokładnie tak jak w sklepie. GET /v1/products/{id} wyświetla tylko opcje, które można zamówić, i zwraca quantity.min oraz quantity.max.
  • Nowy status zamówienia awaiting_setup z polem awaiting_setup dla produktów, które zespół KernelHost konfiguruje ręcznie. Usługi uruchamiane automatycznie są wdrażane dokładnie raz.
  • Body żądań jest ograniczone do 64 KB (HTTP 413). Dla każdego konta obowiązuje limit 120 żądań na minutę łącznie dla wszystkich kluczy, a konto może mieć do 20 aktywnych kluczy. Nieudane uwierzytelnienie nie blokuje już żadnego klucza, a Idempotency-Key jest powiązany z metodą i ścieżką.
  • Żądania z więcej niż jednym parametrem w query stringu (na przykład GET /v1/services?limit=10&offset=0) były odrzucane z kodem HTTP 401. Podpis obejmuje teraz query string dokładnie tak, jak opisano w dokumentacji.

v1.0.0 (2026-05-14)

  • Pierwsze wydanie. Wszystkie 15 endpointów, uwierzytelnianie HMAC, magazyn sekretów AES-GCM, limity szybkości, idempotencja, dziennik audytu.
  • GET /v1/me, /v1/products, /v1/products/{id}
  • POST /v1/orders, GET /v1/orders/{id}
  • GET /v1/services, /v1/services/{id}, /v1/services/{id}/credentials
  • POST /v1/services/{id}/actions
  • GET /v1/billing/balance, /v1/billing/invoices, /v1/billing/invoices/{id}/pdf
  • GET/PUT /v1/webhooks
  • HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.