Sémantické verzování. Breaking changes (přejmenovaná pole, odstraněné koncové body, změna autentizačního schématu) probíhají pouze v nové hlavní verzi pod novým URL prefixem /v2/. V rámci /v1/ probíhají pouze aditivní změny (nová volitelná pole, nové koncové body).
v1.4.0 (2026-11-09)
- Nová cesta GET /v1/services/{id}/metrics (oprávnění read:services): metriky serveru pro období 1h, 6h, 24h, 7d a 14d. Edge Unlimited Traffic VPS poskytují údaje o CPU, paměti, síti a odchozím přenosu, běžné Unlimited Traffic VPS údaje o příchozím a odchozím síťovém provozu v lokalitách uvedených v referenci endpointů.
- Nové cesty GET /v1/services/{id}/ddos/attacks a GET /v1/services/{id}/ddos/attacks/{attack_id} (oprávnění read:ddos): přehledy útoků pro Remote DDoS Protection až 90 dní zpět, s průběhem provozu a členěním podle protokolu, portu, zdroje a velikosti paketů.
- Profily a pravidla (/ddos/profiles, /ddos/rules a zapisovací operace): služba vašeho účtu, která není službou Advanced DDoS Protection, nyní vrací HTTP 409 not_supported_for_product místo HTTP 404. Neznámá nebo cizí ID služeb nadále vracejí HTTP 404.
v1.3.1 (2026-11-02)
- Německo a Francii lze vybrat samostatně: „Německo (Evropa)“ znamená umístění pouze v Německu ve Frankfurtu a „Francie (Evropa)“ pouze ve Francii.
- U běžných Unlimited Traffic VPS v lokalitách Evropa, Německo, Francie, východní Kanada, Spojené království a Polsko může zřízení trvat až 7 dní. Ve většině případů je server připraven do 48 hodin. Zaplacené období začíná až předáním serveru.
v1.3.0 (2026-11-02)
- Advanced DDoS Protection: načítání profilů a pravidel, přidávání pravidel a mazání vlastních pravidel prostřednictvím čtyř nových cest. Výslovně povolte read:ddos a write:ddos; stávající klíče nezískávají nová oprávnění.
- Společné limity panelu a API, postupné provádění změn a povinný Idempotency-Key u POST a DELETE chrání před hromadným vytvářením pravidel a souběžnými požadavky.
v1.2.2 (2026-10-27)
- POST /v1/orders: pokud zaplacenou službu nelze zřídit hned, je její ID nyní uvedeno v poli awaiting_setup (status awaiting_setup), a ne v provisioning_failures se statusem partial. Služba se zřídí automaticky, jakmile to bude možné, a poté přejde do stavu active. V takovém případě objednávku neopakujte.
v1.2.1 (2026-10-26)
- Dedicated Unlimited Traffic VPN: nové lokality s příplatkem v Evropě, Severní a Jižní Americe, Asii, na Blízkém východě, v Africe a Austrálii. GET /v1/products/{id} je uvádí se zobrazovaným názvem a příplatkem. Pokud je taková lokalita právě vyprodaná, vrací POST /v1/orders HTTP 409 location_sold_out. Bez zadání nadále platí první uvedená lokalita (Europe).
- Konfigurovatelné volby (lokalita a operační systém) tarifů Dedicated Unlimited Traffic VPN a Dedicated High Speed Unlimited Traffic VPN mají nová ID, stejně jako jejich podvolby. ID načítejte z GET /v1/products/{id}; napevno uložené staré ID vede k HTTP 400 validation_failed. U služeb těchto tarifů, jejichž status byl již před touto změnou cancelled, terminated nebo fraud, vrací GET /v1/services/{id} location s hodnotou null. High Speed VPN lze nyní objednat už jen s volbami lokality Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) a Poland (Europe).
- Edge Unlimited Traffic VPS: šest nových lokalit (Frankfurt am Main, Londýn, Chester, Paříž, Varšava a Washington DC), celkem až 25. Nové lokality mají vlastní hodnoty sub_option_id, ID dosavadních lokalit zůstávají stejná. U některých tarifů jsou základní cena a příplatky za lokalitu rozděleny nově, celkové ceny dosavadních lokalit zůstávají stejné. ID a ceny vždy načítejte z GET /v1/products/{id}.
v1.2.0 (2026-10-24)
- POST /v1/orders u produktů s volbou lokality (Edge Unlimited Traffic VPS): volba lokality nemá výchozí hodnotu a musí být odeslána v config_options, jinak HTTP 422 s reason location_required. Vyprodaná lokalita vrací HTTP 409 location_sold_out. Nové volitelné pole storage_gb určuje celkové úložiště od 20 do 300 GB. 20 GB je zahrnuto v ceně tarifu a platí, pokud pole vynecháte, každý další GB se účtuje za cenu uvedenou v GET /v1/products/{id}. Jiné hodnoty vedou k HTTP 422 storage_out_of_range.
- U těchto produktů obsahuje výsledek objednávky location a storage_gb (celkové úložiště v GB) a GET /v1/products/{id} popisuje v poli storage rozsah úložiště a cenu za každý další GB. GET /v1/services a GET /v1/services/{id} vracejí location a storage_gb u každé služby (null, pokud produkt takovou volbu nemá).
- GET /v1/products/{id} vrací podvolby už jen s jejich zobrazovaným názvem (například "Finland (Europe)"), bez interní hodnoty před ním. POST /v1/orders odmítá produkty, které jsou právě vyprodané, s HTTP 409 out_of_stock.
v1.1.0 (2026-09-23)
- POST /v1/orders: config_options přijímá pouze volby a hodnoty viditelné v obchodě a množství v rámci jejich limitů. Viditelné volby, které vynecháte, dostanou první uvedenou hodnotu, přesně jako v obchodě. GET /v1/products/{id} uvádí pouze objednatelné volby a vrací quantity.min a quantity.max.
- Nový stav objednávky awaiting_setup s polem awaiting_setup pro produkty, které tým KernelHost nastavuje ručně. Automaticky zřizované služby se zřizují právě jednou.
- Těla požadavků jsou omezena na 64 KB (HTTP 413). Pro každý účet platí napříč všemi klíči limit 120 požadavků za minutu a účet může mít až 20 aktivních klíčů. Neúspěšné ověření už žádný klíč nezablokuje a Idempotency-Key je vázán na metodu a cestu.
- Požadavky s více než jedním parametrem v query stringu (například GET /v1/services?limit=10&offset=0) byly odmítány s HTTP 401. Podpis nyní zahrnuje query string přesně podle dokumentace.
v1.0.0 (2026-05-14)
- První vydání. Všech 15 koncových bodů, HMAC autentizace, ukládání tajných klíčů AES-GCM, omezení rychlosti, idempotence, auditní log.
- 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.

